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thereby selecting cells of the spreadsheet. The control pad can also be used to select items from menus, and select alphanumeric 
characters as parameters for input into the spread sheet. The menus include various software tools and functions, such as vision 
functions. The spreadsheet is semi-transparent, such that the image can be seen through the spreadsheet. The spreadsheet is adapted 
to perform conditional ceU execution. The spreadsheet can also include functions that can operate on values stored over a time 
interval. When the control pad indicates a particular cell of the SjMreadsheet, a change occurs in the appearance of the image displayed. 
The spreadsheet can also include cells ad^ted to buffer outputs, thereby providing circular reference for recursive operation, and 
can mclude ceUs that can be assigned arbitrary depth in a tiime dimension. Also, complex vision objects can be instantiated as a 
single ceU in the spreadsheet, the single ceD having data that is accessible through a plurality of member functions. Moreover, the 
use interface includes a spreadsheet mask for obscuring portions of the spreadsheet, leaving portions unobscured that can be used 
to control operation of the spreadsheet The user-interface is particularly advantageous for machine vision applications, and other 


^ applications using lai^e data sets. 
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Machine Vision Spreadsheet 

Cross-references to Related Applications 

This application is a continuation-in-part application of application No. 
09/370.705, filed 8/9/99, application No. 09/370,706, filed 8/9/99, and 
application No. 09/370,808, filed 8/9/99, and claims the benefit of priority of 
provisional patent application No. 60/160.958, filed 10/22/99, and provisional 
patent application No. 60/169,514, filed 12/7/99. 

Field of the Invention 

This invention relates generally to software user-interfaces and 
programming environments, particularly as applied to industrial automation. 

Background of the Invention 

In the field of factory automation, the high cost of implementing machine 
vision technology represents a significant barrier to the wide-spread adoption 
of industrial vision. Traditionally, a large part of this cost has been attributed to 
the expense of software development. Programmers with specialized machine 
vision experience are often required to accomplish ostensibly simple machine 
vision tasks. Although many attempts have been made to simplify application 
development, there is no clear solution to the machine vision ease-of-use 
problem. 

In general, the ease-of-use problem is concerned with the natural tradeoffs 
between flexibility and simplicity. As any computer interface becomes more 
flexible, it becomes more complex and as such more difficult to use. 
Conversely, simplifying the interface generally limits its range of applicability. 

With the advent of windows-oriented operating systems and graphic user 
interfaces, most machine vision companies have made vision algorithms 
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accessible from interactive graphical interfaces implemented in industry- 
standard shared libraries such as DLL, VBX. COM. and ActiveX. Other 
machine vision suppliers have developed dedicated menu-driven interfaces. 
Still others have created elaborate graphical programming environments 
based both physical and abstract connection metaphors. None of these 
paradigms have proven completely satisfactory. 

Library interfai;es, even those offering active graphical components, are 
essentially programming accessories. The user must still construct an intricate 
sequence of instructions linking the various vision primitives into a single 
application. This process requires a skilled software developer. 

Menu-driven systems do not require conventional programming but are too 
inflexible to be considered generally purpose. These systems are limited to 
narrow application domains where all aspects of an application setup and 
configuration can be anticipated. 

Graphical programming seems like an improvement over conventional 
programming, but in reality the arcane nature of the metaphor represents a 
substantial challenge to an unskilled user. Connecting wires to boxes may be 
a more playful way to generate code, but the true ease-of-use advantages are 
negligible. 

The superior ease-of-use characteristics of conventional electronic 
spreadsheets are well-known, especially in the field of office automation. The 
use of electronic spreadsheets in other fields is also known, although in the 
past, certain computer applications have been unable to take full advantage of 
the spreadsheet metaphor. One reason for this is that a large class of 
computer applications require algorithms that operate over time-based 
intervals of a continuous data stream, and conventional spreadsheets provide 
no intrinsic support for continuous data processing over more than one 
processing interval. 

An electronic spreadsheet is, essentially, a means of graphically 
representing a set of expressions as a grid of cells. Each cell in the 
spreadsheet grid represents a parenthetical expression that can, in turn, be a 
function of some number of other cellular expressions. 
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A spreadsheet program updates its grid, as necessary, to maintain the 
programmed relationship between cellular expressions. Electronic 
spreadsheets are intended to provide immediate response to any 
modifications of the programmed expressions. However, in conventional 
electronic spreadsheets, cellular expressions have no means for accessing 
previously evaluated results from prior processing intervals. Absent this 
capability, it is impossible for a conventional spreadsheet to process a 
continuous data stream of incoming data on a time-based interval of a 
duration greater than one processing interval. 

Although methods for implementing algorithms that operate on continuous 
data streams are well-known in computer programming, no methods are 
known for implementing this class of processing within the context of an 
electronic spreadsheet. 

Machine vision programming tasks typically involve the manipulation of 
images and other large data sets, a task poorly suited to conventional 
electronic spreadsheets. 

A standard spreadsheet consists of a rectangular grid of cells, each cell 
representing a single value that is, in turn, a function of some number of other 
cells in the grid. The standard electronic spreadsheet is suited for 
implementing formulas that require a relatively small number of input values 
and generate a single scalar output. In contrast, certain machine vision 
functions are parameterized by arguments representing a million or more pixel 
values. Since there is no facility in a standard electronic spreadsheet that 
enables a single cell to represent multiple values, the standard spreadsheet 
model is clearly not suited to support functions that operate on images and 
other large data sets. 

In the fields of scientific visualization and computer graphics, the term 
"spreadsheet*' has been loosely applied to certain programs that manage 
multiple images and other data representations in a two-dimensional 
rectangular grid within a bounding window. These programs, typically 
designed for graphical editing and array processing, essentially, allow 
individual data cells to be formatted as data arrays. However, in order to 
accommodate data sets of varying size, these interfaces generally abandon 
the strict two-dimensional grid relationship between cells that is the essence 
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of the spreadsheet paradigm. In fact, most of these programs are 
unrecognizable as spreadsheets, and are generally unsuited for machine 
vision. 

In the past, many computer applications have been unable to take 
advantage of the spreadsheet metaphor. One reason for this may be that 
computer applications are often required to exhibit conditional statement 
execution behavior. However, conditional statement execution behavior is 
beyond the capability of conventional electronic spreadsheet programs. 

In the field of pattern recognition, for example, it is common for a single 
program to execute one set of instructions during training, and another set of 
instructions during classification, the instructions for classification being 
dependent on exemplar data extracted during training. In this field it is also 
common for programs to dynamically adapt their order of execution based on 
external control parameters. Consequently, known electronic spreadsheets 
cannot adequately be used for programming applications in the field of pattern 
recognition. 

In conventional programming, positional order of program statements and 
conditional branching within program statements drive the order of execution 
of the program statements. In the BASIC programming language, for 
example, a program statement at line 20 in a program listing is always 
executed after the program statement at line 10, unless a branch statement is 
encountered and a jump instruction is invoked. 

Unlike a programming language, an electronic spreadsheet is essentially 
a means for graphically representing a single expression by distributing the 
expression across a rectangular grid of cells (or any regular array of cells), 
each cell being a parenthetical expression that can be a function of some 
number of other expressions in cells across the grid. As in typical expression 
evaluation, precedence and dependencies drive the order of execution. Since 
the order of execution is not explicitly programmed, there is no spreadsheet 
equivalent to a jump instruction in conventional spreadsheets. This limitation 
of conventional spreadsheets makes programming certain kinds of behavior 
difficult, if not impossible. 

Conventional electronic spreadsheets are known to support limited 
conditional behavior, e.g., conditional argument value assignment using the 
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I Standard IF functions An IF function consists of three arguments: A, B. and 

I C, where argument A is a logical switch expression, and arguments B and C 

I are the two possible expressions to be evaluated. If the expression in 

I argument A evaluates TRUE, the expression In argument B is evaluated and 

I 

I returned. If the expression in argument A evaluates FALSE, the expression in 

I argument C is evaluated and returned. 

I 

I Like IF, the CHOOSE function simply evaluates and returns one of N 

i 

I expressions. The evaluation of the expression in the first argument of the 

I CHOOSE function determines which of the N expressions will be evaluated 

\ and returned, which is essentially a generalization of the IF function. 

[ However, the functions IF, CHOOSE, and similar functions, are only capable 

I of selecting among result values, and are incapable of controlling the order of 

I execution of expressions associated with a cell or a set of cells within the 
spreadsheet. 


Summarv of the Invention 

Overcoming the problems of the known ease-of-use approaches, the 
invention introduces a spreadsheet environment and programming model, 
powerful enough to be applied to a wide range of problems, yet accessible to 
one who typically does not have programming experience or expertise, such 
as a typical manufacturing engineer. 

Although spreadsheets are widely used in manufacturing, they are not 
available as a framework for use in industrial computer vision. 

Spreadsheet ease-of-use derives from the almost purely modeless character 
of its easily mastered intelligent worksheet metaphor. Unlike conventional 
programming, the development environment, run-time environment, and user 
interface are all one and the same. In the spreadsheet, there are no abstract 
modes; what you see is truly what you get. Change any number or any 
formula in any cell and everything else updates automatically. 

The challenge met by the invention was to develop a spreadsheet- 
programming environment for industrial machine vision. Ideally, this would 
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have been accomplished by simply finding an existing spreadsheet engine 
and adding vision functions. Unfortunately, standard spreadsheets are 
inadequate for industrial machine vision. Achieving the desired result required 
substantial extensions to the fundamental spreadsheet model. 

One aspect of the invention is a spreadsheet interface for programming 
industrial machine vision applications. The machine vision spreadsheet of the 
invention offers many key improvements over conventional spreadsheets, as 
detailed herein below. 

Semitransparent Worksheet Superposed on image 

The user interface of the invention seamlessly integrates the worksheet and 
the image. The worksheet grid appears to be a semitransparent sheet 
situated on top of an image display. This technique lets the user 
simultaneously view a full screen image and the associated worksheet. 
Alternative techniques include displaying the image and the worksheet side- 
by-side or supplying a means to flip from one display to the other. Both of 
these alternatives have significant drawbacks. 

Locating the image beside the worksheet creates display size limitations. On 
small monitors, common to most production environments, both the image 
and the worksheet would be small and difficult to see. Such an interface 
would probably need to scroll the image window or scale it into a low- 
resolution fomnat. Scrolling techniques that hide large sections of the image 
tend to cause confusion, since it is never quite clear which section of the 
camera's field of view is being displayed. Scaling the image into a low- 
resolution window is also undesirable, since graphics overlays such as 
crosses and region boxes cannot be positioned with single pixel precision. 

Making the image and worksheet displays mutually exclusive presents an 
important ease-of-use limitation. This technique makes it difficult to reinforce 
the relationship between the contents of the image and the contents of the 
worksheet. In the ViewPoint user interface, changing the contents of the 
image can lead to changes in the contents of the worksheet. Similariy, 
changing the contents of the worksheet can lead to changes in the image. 
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p When the image and the worksheet display are mutually exclusive, the 

I relationship between cause and effect becomes detached. In other words, it 

I becomes difficult for the user to associate actions taken in the worksheet with 

I results appearing in the image. 

I In preferred technique — the one employed by the user interface aspect of the 

I invention — a semitransparent worksheet is superimposed on a full resolution 

I image display. This approach supplies immediate feedback'for us«r-initiated 

}. actions executed in either domain. When necessary, the image can still be 

[ displayed exclusively, but this can be reserved for times when the image 

I demands system modal focus. 

Remote Input Device Suitable for a Manufacturing Environment 

I 

I Most spreadsheet user-interfaces run on business workstations, typically 

^ personal computers. The manufacturing environment for machine vision is far 

different and far less accommodating than the typical office environment. 

Users are often standing, with no desk for a keyboard and mouse. In addition. 

operators may need to be several feet away from the computer monitor to 

adjust the trigger, the camera, the lights, and other remote components. 

The user interface aspect of the invention better accommodates the 
manufacturing environment. Its pendent remote interface device lets 
operators control the vision system while standing at a distance from the 
monitor, even while wearing gloves. Operators navigate using a combination 
of four direction buttons and four action buttons. Unlike any other spreadsheet 
interface or environment, an entire application can be constructed using a 
total eight buttons. Although it somewhat less familiar than the 
keyboard/mouse combination, it is. nonetheless, well suited for its intended 
purpose and far superior to conventional input devices, given the practical 
constraints imposed by the manufacturing environment. 

Worksheet Focus Coordinated with image Display 

As explained above, the user-interface aspect of the invention strives for the 
seamless integration of the spreadsheet and the image. It achieves this partly 
by simultaneously displaying image and worksheet data. Beyond simple 
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overlaying data, the invention coordinates browsing in the spreadsheet with 
presentation of the image. The spreadsheet cell that has focus — that is. the 
cell selected — can automatically cause a change in the image display 
consistent with the associated worksheet formula. The feature is also referred 
to as "flyover", in that as the point of focus "flys over" the cells of the 
spreadsheet, the associated image changes in some way. The image is 
typically visible through the spreadsheet displayed as a semi-transparent 
(translucent) image. For example: 

When a cell with an image-related input parameter is selected, the associated 
parameters are graphically depicted in the associated image. 

When an image-processing cell is selected, the invention automatically 
displays the processed image. 

When a graphics cell is selected, the associated graphic component will be 
activated in the associated image. If it is already visible, its color will be 
changed so that it can be uniquely identified. 

2D Image Integrated in Dependency Tree 

In most programming languages, positional order and conditional branching 
drive the order of execution. In BASIC, for example, line 20 is always 
executed after line 10. unless a branch is encountered and a GOTO LINE# 
statement is invoked. Unlike a conventional programming language, a 
spreadsheet is essentially an elaborate representation of a single expression. 
As in expression evaluation, precedence and dependencies drive the order of 
execution. 

For example, in the expression X=A*(B+C), the parenthetical expression 
(B+C) is always executed first. This is true even if the order with respect to the 
factor A is reversed, as in X-(B+C)*A. The parentheses enclosing B+C 
indicate to the expression evaluation engine that adding takes precedence 
over the multiplication. Taking the example a step further, in the expression 
X=A*((B+C)*(D+E)), (B+C) and (D+E) are executed first, but the order of 
execution is unspecified and unimportant 
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In a spreadsheet, any expression contained within a cell is the functional 
equivalent of a parenthetical expression. So, if a cell Z contains B+C. cell Y 
contains D+E, and cell X contains A*Y*Z. then cell X is functionally equivalent 
to the expression X=A*((B+C)*(D+E)), since cells Y and Z must be satisfied 
before cell X can be evaluated. Spreadsheet execution is driven by 
dependency, not by the order or position of the active cells. The spreadsheet 
aspect of the invention makes important contributions to the known 
spreadsheet paradigm by introducing, among other aspects, two-dimensional 
image data, complex data structures, and objects into the dependency graph. 

Most known spreadsheet interfaces allow users to insert bitmap image data in 
the worksheet, but this is mostly for simple display. The vision spreadsheet 
interface of the invention is unique in its integration of two-dimensional images 
with worksheet formulas. Unlike most spreadsheets, which deal with images 
by simply overlaying bitmaps on top of cells, the invention represents an 
entire image with a single cell. According to an aspect of the invention, an 
image acquisition initiates a chain of execution starting with those cells that 
reference the acquisition buffer as an input data. If an image feature 
extraction operation depends on some form of image preprocessing, then a 
reference to the preprocessed image cell can be passed as an argument to 
the image feature extraction function. 

More concretely, suppose the objective is to inspect the contrast of a 
preprocessed image region. The end result is pass/fail flag, where 1=PASS 
and 0=FAIL. One could write the pseudo-expression: 

OUTPUT(Bit#.CONTRAST(HISTOGRAM(IMAGEPROCESS(ACQBUF 
FER)))>Thresh) 

As in the previous example, this expression could be split into individual cells. 


CELL A= IMAGEPROCESS(ACQBUFFER) 
CELL B= HISTOGRAM(A) 
CELL C= CONTRAST(B) 
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CELL D= Thresh 

CELL E= OUTPUT(Bit#.C>D) 

When the system of the invention receives an acquisition trigger, the new 
image data drives the update of (Cell A). (Cell A) creates a processed image 
represented by (Cell A). These events force the update of (Cell B), which 
represents the grayscale histogram of (Cell A). After the histogram is 
computed, the image memory associated with (Cell A) can be automatically 
released, since all dependencies associated with the processed image have 
been satisfied. (Cell C) reduces the contrast to a single value. (Cell E) 
compares that value to a threshold stored in (Cell D) sending the Boolean 
result to a specific bit of discrete I/O. 

In addition to simple cell dependencies, the spreadsheet of the invention 
understands and manages regions of interest within image buffers. Data 
written to a specific section of an image buffer represented by a single cell will 
update only those cells dependent on the pixels written. If in this example, an 
acquisition were directed to a region of interest that doesn't intersect with the 
image-processing region, the chain of execution would not be initiated. This 
Is because there would have been no actual change of pixel input data with 
respect to the image-processing operation in (Cell A). 

Expressions can Depend on Clock input 

As described above, spreadsheet execution is driven by the need to update 
dependent expressions. According to the spreadsheet of the invention, 
however, expressions may be dependent on external clock input Therefore, 
broadcasting a clock input to the spreadsheet causes clock dependent cells to 
update. A clock signal of the invention can be the result of a manual trigger 
action, a free running clock, a timed internal clock, or an external trigger. The 
presence of this clock dependency gives the spreadsheet of the invention 
unique advantages, allowing the extension of spreadsheet techniques into the 
time domain. 
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Expressions Respond to Coded Triggers 

As described above, all cells and expressions respond to global external clock 
input. Cells respond to this clock signal in one of three ways: Run, Define, or 
Refine. 

The Run response is the normal spreadsheet response: cells simply execute 
their nominal function. 

The Refine signal tells cells that react to Refine to take the image and 
worksheet data existing from the previous clock step and use it to update their 
internal state. For example, a search might take the most recent POSE result 
coordinates and use them isolate image data for the purposes of updating a 
stored model template. 

The Define signal tells cells that react to a Define to execute a Define 
process. For example, the search function might respond by automatically 
bringing up the search property sheet and prompting the user to train a new 
model template. 

This unique ability to respond to coded triggers allows the spreadsheet of the 
invention to react much as If it were a single vision tool. The user of the 
spreadsheet of the invention, using this capability, can develop not only the 
run-time sequence of operation but also specify the pattern of both manual 
and automatic training behavior. 

Special Ceils Buffer Outputs for Recursive Operation 

As described above, all cell expressions implicitly depend on clock input. This 
statement is not intended to imply that a clock signal is required to achieve 
output. The clock is simply one of. potentially, several inputs that must be 
satisfied. 

A conventional spreadsheet does not employ the concept of a globally 
synchronized system clock. Outputs occur as data propagate freely along a 
chain of dependencies. Unlike conventional spreadsheets, the invention 
supports the concept of clocked cells. A clocked cell acts in two phases of the 
global clock: In the first phase, inputs are satisfied and an output is 
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generated. In the second phase, the output buffer is copied into the internal 
buffer. 

This architecture makes it possible to construct items such as counters and 
accumulators — something impossible in a known spreadsheet. 

For example, suppose one wanted to count defects. Let the defect be 
asserted by a (1) TRUE output in (Cell A). Let the counter be in (Cell B). In the 
spreadsheet of the invention. (Cell B) could contain the expression B=B+A — 
that is. take the contents of (Cell A), add it to the contents of (Cell B), and 
leave the result in (Cell B). This syntax is legal only because (Cell B) is a 
clocked cell. On the first phase of the clock signal, (Cell B) copies its contents 
into a local buffer. On the second phase, (Cell B) accesses its own buffer and 
(Cell A), sums the two values, and places the result in (Cell B)'s output Since 
clocked cells update only on the external clock signal, the circular reference is 
interrupted by the clock input signal parameter, as illustrated below. 


Clock 


Defect 

Cell A 
A 

Defect Counter 

Cells 
Bo 

Bb 



0 

0 

0 

0 

phase 1 

1 

1=A+Bb 

0 


phase 2 

1 

1 

1=Bo 

1 

phase 1 

0 

1=A+Bb 

1 


phase 2 

0 

1 

1=Bo 

2 

phase 1 

1 

2=A+Bb 

1 


phase 2 

1 

2 

2=Bo 

3 

phase 1 

1 

3=A+Bb 

2 


phase 2 

1 

3 

3=Bo 


Table 1 

In this example, three (3) defects occur in four (4) clock cycles. A conventional 
spreadsheet cannot duplicate this simple behavior. Clocked cells are 
essential for time domain integration. 

Special Functions Support Data Buffering over Time 

The above discussion describes a simple clocked cell. The spreadsheet of the 
invention supports another variety of clocked cell by way of the FIFO function, 
which allows spreadsheet users to create pipeline buffers of arbitrary depth. 
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The FIFO function clocks data through a first-in-first-out shift register. The 
output is the data from N clock periods ago. where N is the depth of the 
pipeline. The pipeline can also be tapped at any depth necessary. This 
represents a unique and powerful function with respect to spreadsheet 
machine vision. Consider three examples: 

To compute a Pass-Fail output based on the average of the last N feature 
responses, the FIFO function could be tapped to access the previous N 
responses, which could be averaged and compared to the current value. 

To delay the output of a Pass-Fail signal — a common problem on assembly 
lines, since rejects can rarely be handled at the vision inspection station— the 
Pass-Fail can be fed into a FIFO of the appropriate depth. The pipeline can 
also be tapped to support actions at any stage between the inspection station 
and the final reject station. 

To compute the velocity of a feature coordinate, three FIFO pipelines could be 
created. As the feature is located, the first FIFO inputs X coordinate, the 
second inputs the Y coordinate, and the third inputs a real-time clock. By 
appropriately tapping the three FIFOs, it is possible to compute the time- 
based derivatives of the image feature. 

These three tasks are impossible using conventional spreadsheet operations. 
A Coherent Hierarchy of Data Reduction 

The spreadsheet function interface of the invention has many examples of 
cells that represent more than one value. For example, template search not 
only returns the number of templates found, it also buffers the POSE 
coordinates, the score for each result, and internal state data including the 
trained template. This kind of cell, which we call a complex cell, is actually 
more like an object than a function. The spreadsheet of the invention 
preserves the standard single-value return paradigm by providing data-access 
member functions. For example, the POSE row coordinate of a search results 
in A1 is available through the access function PoseRow(AI.O). 
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An elegant feature of the spreadsheet vision architecture of the invention is 
that image buffers, like vision tools, are treated as complex objects. Image- 
buffer access functions are vision tools. The image acquisition buffer is simply 
a complex cell accessed by vision tools that are in turn accessed by 
increasingly higher-level access functions. Image data is. therefore, 
systematically reduced to scalar values that can be manipulated by 
conventional means. 

Sine the spreadsheet paradigm forms the basis of many of the worlds most 
success computer applications, e.g., Lotus 123 and Microsoft Excel, literally 
millions of users are already familiar with the concept of worksheet based 
computer programming. Consequently, another important advantage of the 
machine vision spreadsheet of the invention is that users in an industrial 
environment will probably already be familiar with the basic aspects of the 
user interface of the invention. Remarkably, despite the acceptance of 
conventional spreadsheets in manufacturing, industrial machine vision 
products have never successfully adopted spreadsheet-programming 
techniques. This is due, in large part, to the inability of conventional 
spreadsheet products to manage the dimension and complexity of the 
machine vision application domain. 

Vision applications introduce many complications including an inherent time 
dimension, complex data types, and special human interface constraints. The 
invention addresses these complications with innovative extensions including: 

Clocked cells and FIFO functions to extend cell dimensionality in time; 

A coherent methodology for manipulating and reducing complex data; and 

Special human-interface input means and graphical display techniques. 

By adapting the well-known spreadsheet-programming paradigm, the 
enhanced spreadsheet of the invention succeeds in bringing new flexibility 
and intuitive ease-of-use to a significant number of industrial automation 
problems, such as machine vision problems, that could otherwise only be 
solved through complex conventional programming techniques. 
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The invention also provides an electronic spreadsheet adapted for 

5j programming the processing of continuous data streams. The invention also 

I 

1^ provides means and methods that, to a high degree, preserve the 

I fundamental characteristics of conventional electronic spreadsheets. The 

I invention also provides means and methods, which are uncomplicated and 


^ intuitive to use. 


These benefits and features are accomplished by extending the 
spreadsheet paradigm to include apparatuses and methods of clocked data 
buffering, such as by using shift registers, delay lines, FIFOs, pipelines, and 
even random access memory. The use of shift registers is preferred because 
shift registers do not require addressing. Delay lines objects are instantiated 
(memory is allocated for each delay line object) and assigned to spreadsheet 
cells (each allocated memory is associated with the coordinates of a cell). A 
delay line object includes a data buffer configured as a variable length shift 
register, and a method for clocking data through the buffer. In a preferred 
embodiment, input data streams supply the clocking signals, and "tap 
functions" support random access of elements, and other analysis over the 
buffered interval. 

The invention extends the conventional electronic spreadsheet paradigm 
to include the processing of continuous data streams on finite intervals. 

The invention further provides methods for adapting electronic 
spreadsheets to applications in the field of industrial machine vision, while 
also substantially preserving the fundamental characteristics of conventional 
electronic spreadsheets. The invention also makes efficient use of a given 
display area and resolution, using for example, a semitransparent 
spreadsheet superimposed over an image of the contents of a data buffer. 
Further, the invention facilitates and simplifies the manipulation of images and 
other large data sets, while preserving the ease-of-use, and other advantages 
and benefits, of the spreadsheet paradigm. 

The invention exploits a new class of object-oriented spreadsheet 
functions that incorporate internal data buffering. In addition, the invention 
provides methods by which the graphical representation of buffered data sets 
may be displayed simultaneously with a spreadsheet grid, preferably as a 
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graphics layer positioned beneath a variably transparent spreadsheet grid. A 
split-screen and dual screen approach can also be employed for displaying 
the buffered data sets alongside the electronic spreadsheet. 

In a preferred embodiment, a conventional spreadsheet is extended to 
include data buffering functions, herein referred to as "single method objects", 
because from the perspective of the spreadsheet programmer, there is only 
one public member function, i.e., only one public method. For example, in 
accordance with the invention, the familiar "search" tool of machine vision is 
the public member function of the search object, which includes a search 
function, as well as data associated with the search function. 

A single method object can be instantiated and assigned to a spreadsheet 
cell within a variably transparent grid superimposed on a graphical display 
buffer, the contents of the graphical display buffer being determined in 
accordance with the currently selected cell. If an empty cell, or a cell 
containing a conventional spreadsheet formula is selected, the image last 
acquired is stored and displayed in the underlying graphical display buffer. If a 
cell containing a single method object is selected, a graphical representation 
of the object data members is stored in the underlying buffer and displayed. 

The foregoing methods selectively extend data dimensionality to meet the 
practical requirements of machine vision processing, while still retaining the 
fundamental characteristics and ease-of-use of a conventional electronic 
spreadsheet. 

The invention also provides methods and apparatuses for programming 
conditional execution behavior in an electronic spreadsheet, and therefore 
methods of programming the order of execution of expressions associated 
with cells in an electronic spreadsheet. While providing such methods and 
apparatuses, the invention preserves the fundamental characteristics of 
conventional electronic spreadsheets to a high degree. Moreover, the 
methods and apparatuses of the invention for programming conditional 
behavior in electronic spreadsheets are easy and intuitive to use. 

The invention includes implicit conditional wrappers associated with each 
cell of the electronic spreadsheet, whereby the execution of each cellular 
expression is conditioned upon the state of an individually assigned logical 
switch expression included in an associated implicit conditional wrapper. 
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In a preferred embodiment, every expression in every cell is enabled or 
disabled by an implicit conditional wrapper. This implicit conditional wrapper 
uses a logical switch expression to control the execution of the ceirs 
expression, i.e.. to enable or disable the execution of the ceirs expression 
based on the value of the logical switch expression. 

In a preferred embodiment, the logical switch expression is entered into 
the implicit conditional wrapper of a cell using a pop-up dialog box and an 
associated pop-up window, for example. The dialog box can then be closed 
by the user, causing the pop-up window and its entered logical switch 
expression to disappear along with the dialog box. Closing the dialog box 
makes the logical switch expression appear to no longer be associated with 
the cell, thereby making the logical switch expression invisible or "implicit", 
because the existence and nature of the logical switch expression is not 
visible to the user solely by looking at the contents of the cell. However, the 
effects of the logical switch expression become manifest upon execution of 
the electronic spreadsheet. 

The logical switch expression can be any legal spreadsheet expression 
that can be evaluated to logical TRUE or FALSE. If the logical switch 
expression evaluates to TRUE, the cell's corresponding expression is 
evaluated, a new result value is returned, and the ceirs internal result buffer is 
updated accordingly. If the logical switch expression evaluates FALSE, the 
cell's expression is not evaluated, and the cell's result buffer is returned 
unmodified. 

In a preferred embodiment, individual switch expressions are initialized to 
a constant logical TRUE. In another preferred embodiment, the spreadsheet 
user interface supports the interactive assignment of a switch expression to 
any cell or range of cells within the spreadsheet, using dialog boxes and pop- 
up windows, for example. A user selecting a "cell state" display mode from a 
menu after selecting a cell will cause a dialog box to appear, along with an 
associated window that displays the associated logical switch expression. 

The default behavior of the improved electronic spreadsheet is unaffected 
by the extensions and improvements described above if all individual logical 
switch expressions are initialized to a constant logical TRUE. In this case, a 
user can ignore the implicit conditionals. Alternatively, the user can mark 
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arbitrary sets of cells, and then selectively assign logical switch expressions to 
program desired electronic spreadsheet behavior beyond the capacity of 
known electronic spreadsheets, such as providing various orders of cell 
execution. 

The invention efficiently and elegantly extends the conventional 
spreadsheet metaphor to meet many of the fundamental requirements of 
conditional expression execution in computer programming. 


BRIEF DESCRIPTION OF DRAWINGS 

The invention will be more fully understood from the following detailed 
description, in conjunction with the following figures, wherein: 

Fig. 1 is an example illustrating methods of electronic spreadsheet 
programming for processing continuous data streams of the invention; 

Fig. 2 is an example output sequence illustrating the response of the 
example program of Fig. 1 to a specific input sequence; 

Fig. 3 is a diagram illustrating the components of a delay line object; and 
Fig. 3A is a diagram of the parameters of the delay line object of Fig. 3. 

Fig. 4 is a block diagram of a computer system for suitable for practicing 
the invention; 

Fig. 5 illustrates a superposition of graphics layers to obtain the user- 
interface graphics display of the monitor of Fig. 4 ; 

Fig. 6 is a depiction of the graphical user interface of the invention with 
cell A1 selected of a semi-transparent spread sheet that is superimposed on 
the image corresponding to the single method object instantiated in cell A1; 

Fig. 7 is a depiction of the graphical user interface of the invention with 
cell A2 selected of a semi-^transparent spread sheet that is superimposed on 
the image corresponding to the single method object instantiated in cell A2; 

Fig. 8 is a depiction of the graphical user interface of the invention with 
cell A3 selected of a semi-transparent spread sheet that is superimposed on 
the image corresponding to the single method object instantiated in cell A3; 


18 


wo 01/11445 


PCT/USOO/22383 


I Fig. 9 is a depiction of the graphical user interface of the invention with 

I 

i cell A4 selected of a semi-transparent spread sheet that is superimposed on 

I the image corresponding to the image last acquired; 
^ Fig. 1 0 is a sequence of four instances of a portion of an electronic 

I spreadsheet incorporating the improvement of the invention, each instance 

I including a dialog box and a pop-up window making explicit the logical switch 

I 

I expression of the conditional wrapper associated with each cell of the 

ji improved spreadsheet of the invention; 

I Fig. 11 is a listing BASIC computer program that is the functional 

f. 

I equivalent of the spreadsheet of Fig. 10; 

I Fig. 12 is a flow chart illustrating a method of the invention for 

[ programming conditional execution in an electronic spreadsheet 

[ Figs. 13-16 are flowcharts representing the logic of an unimproved 

I spreadsheet; 

I Fig. 1 3 is a flowchart of the main loop of a spreadsheet without the 

I extensions of the invention; 

I Fig. 14 is a flowchart of the DisplaySheetO module of Fig. 13; 

I Fig. 1 5 is a flowchart of the EvaluateSheet (Row.Col) of Fig. 1 3; 

i Fig. 16 is a flowchart of the EvaluateCell (u.v) of Fig. 15; 

Figs. 17-29 provide a hierarchically structured flowchart of an example 
i program supporting methods of the current invention, wherein: 

j Fig. 1 7 is a flowchart of the main processing loop; 

^ Fig. 18 is a flowchart of a function to display cell contents; 

Fig. 19 is a flowchart of a function to input new formulas; 

Fig. 20 is a flowchart of a function to update the spreadsheet 

Fig. 21 is a flowchart of a function to respond to a trigger; 

Fig. 22 is a flowchart of a function to display the extended data ; 

Fig. 23 is a flowchart of a function to display a data cell; 

Fig. 24 is a flowchart of a function to execute a single formula ; 

Fig. 25 is a flowchart of a function to execute dependent formulas; 

Fig. 26 is a flowchart of a function to execute conventional formulas; 

Fig. 27 is a flowchart of a function to execute extended formulas; 

Fig. 28 is a flowchart of a function to allocate cell data; and 

Fig. 29 is a flowchart of a function to de-allocate cell data. 
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Detailed Description of Preferred Embodiments 

Referring to Fig. 1, a sequence of user interface screens 1. 2. 3. 4. 5, and 
6 illustrates how a spreadsheet processes a continuous data stream 
according to the invention. Displayed is a spreadsheet program that computes 
the square root of the sum of the squares of the last three data elements of a 
continuous data stream. The spreadsheet program of Fig. 1 is constructed in 
6 expressions entered in cells B1, B2, B3, 84, B5, and B6. 

Cell B1 contains an external input function "INPUT(1)". The input function 
"INPUT(1)" accesses a data source "1" external to the spreadsheet. In this 
example, we assume that cell B1 updates periodically as a function of some 
unspecified external event, e.g.. in response to data on the lines of a parallel 
port whenever a line is toggled, or in response to a pixel value at specified 
coordinates in an image at a particular time. 

Cell B2 contains an instance of a delay line object, and is parameterized 
with four parameters: the input data stream (B1*B1). the clock source (B1), 
the number of elements in the shift register (3), and the clock divider (1). 

Referring to Fig. 3, a delay line object 30 consists of a data buffer 32 
configured as a variable length shift register (or as a delay line, FIFO, 
pipeline, etc.), and a method for clocking data through the buffer 34. The 
clock signal 34 indicates when data is valid for processing in the spreadsheet. 
Input data streams supply the clock signals 34, and "buffered interval" 
spreadsheet functions support the random access of elements and other 
analysis over the buffered interval. For example, parallel random access of 
data elements is performed using "tap functions" 36 that independently 
access single values from the delay line buffer 32 at particular specified 
locations by calling methods 37 of the delay line object. Analysis over the 
buffered interval includes any vector operation on the data buffer, including 
summing the buffer, and performing a standard deviation or other statistical 
analysis on the buffer. Further, other sources of clocking signals include a 
timer (e.g., a clock edge every 20 seconds), an image acquire signal, or a 
parallel port, or any external event, for example. Other spreadsheet entities 
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can also provide clock signals. The delay line object also includes a plurality 
of parameters 40. as detailed in Fig. 3A. 

Referring to Fig. 3A. the delay line object is parameterized by four 
arguments. The first argument is the input data stream 31; the second 
argument is the clock source 33; the third argument is the number of elements 
in the shift register buffer (delay line) 35; and the forth argument is a clock 
divider 39. 

In the example of Fig. 1 , the data source is defined by an expression that 
squares the input data stream B1 ; the clock source Is referenced to cell B1 ; 
the number of daita elements in the shift register is three; and the sample rate 
is one per cycle. So. when data is received in B1. it is squared and input to a 
three-element delay line. 

Cells 83. 84, and 85 access the delay line instantiated in 82 to return the 
values of all three elements in the delay line data buffer. The tap function 
TAP(B2,0) in cell B3 accesses the last data item to be input to the delay line 
in cell B2. The tap functions TAP(B2.1) and TAP(B2.2) in cells 84 and 85, 
respectively, access data that was input on the previous two clock cycles 1 
and 2. 

Cell 86 completes the processing by referencing 83. 84, and 85 in a 
computation of the square root of the sum of the three values 83, 84. and 85 
returned from the delay line's buffer. 

Fig. 2 shows the final four spreadsheet display states that result when the 
spreadsheet program of Fig. 1 processes the input data stream 
{1.00.2.00,3.00.4.00.5.00.6.00}: 

At time (T-3) cells 83. 84 and 85 display the values 9.00, 4.00. and 1 .00. 
respectively, resulting from the squaring of the first three input data elements 
3.00. 2.00, and 1.00; 

At time (T-2) the value 16.00. the square of the input data value 81=4.00 
(81*81). shifts into the delay line; 

At time (T-1) the value 25.00, the square of the input data value 81=5.00 
(81*81) shifts into the delay line; and 

At time (T-0) the value 36.00, the square of the input data value 81=6.00 
(81*81) shifts into the delay line. 
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For every cycle, the square root of the sum of the delay line contents 
(Mag) Is computed by the expression assigned to cell B6: 
(B6=SQRT(B3+B4+B5)). 

The input function INPUT(1) receives data from an external source and 
updates the value assigned to B1. The delay line object in B2 
(B2=DELAY(B1*B1.B 1,3.1) is clocked by the input function, and a new value 
is shifted into the data buffer upon each new input. The three tap functions 
TAP(B2.0). TAP(B2,1).and TAP(B2.2) are def-endent on the contents of the 
delay line B2, and update in an unspecified order. Finally, the expression in 
B6 (SQRT(B3+B4+B5)) is dependent on B3, B4. and B5, and is evaluated, 
the result being assigned to B6. At this point, all dependencies have been 
satisfied, and the contents of the spreadsheet remain unchanged until the 
next input event occurs. 

In the forgoing example, the delay line expression in B2 behaves in a way 
very different from a conventional spreadsheet expression. First, the delay 
line is not a function; rather, it is an object instance, i.e.. there is data storage 
(memory) allocated. Delay line class objects combine data storage with a 
member function that implements the shift register, for example. 

Second, unlike a conventional spreadsheet expression that is evaluated 
only as necessary to update the spreadsheet, according to the invention, the 
evaluation of the delay line member function is executed only upon triggering 
by a clock signal. The value of the input to the delay line member function 
does not need to change to force the evaluation of the delay line member 
function. The state of the source data argument is irrelevant; the shift register 
action can only be activated by a signal from a valid clock source, such as the 
input function in the example. 

Referring to Fig. 3, the delay line object 30 consists of a data buffer 32 
configured as a variable length shift register (or as a delay line, FIFO, 
pipeline, etc.), and a method for clocking data through the buffer 34. The 
clock signal 36 indicates when data is valid for processing in the spreadsheet. 
Input data streams supply the clock signals 36, and buffered interval functions 
support the random access of elements, and other analysis over the buffered 
interval. For example, parallel random access of data elements is performed 
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using "tap functions" 38 that independently access single values from the 
delay line buffer 32 at particular specified locations by calling methods 37 of 
the delay line object. Analysis over the buffered interval includes any vector 
operation on the data buffer, including summing the buffer, and performing a 
standard deviation or other statistical analysis on the buffer. Further, other 
sources of clocking signals include a timer (e.g., every 20 seconds), an image 
acquire signal, a parallel port, or any external event, for example. Other 
spreadsheet entities can also provide clock signals. 

The delay line object 30 also includes a plurality of parameters 40, as 
detailed in Fig. 3A, including, for example, the Input data stream 31, the clock 
source 33, the number of elements in the shift register, and the clock divider 
39. 

Large Data Sets 

Referring to Fig. 4, a preferred spreadsheet user interface for machine 
vision applications includes a monitor 41 connected by cable to a computer 
42. The computer 42 includes image acquisition, processing, and graphical 
display capability. A camera and lens assembly 43 has an object surface 45 
within its field of view, and is connected to the computer 42. Also, connected 
to the computer 42 is a user input device, such as a game controller 44, or a 
standard keyboard (not shown). 

The screen of the monitor 41 depicts a semitransparent spreadsheet 46 
superimposed on an image and graphics layer 47 to form a composite display 
of the invention. The transparency of the semitransparent spreadsheet 46 
can be adjusted by the user The semitransparent spreadsheet 46 can also 
be displayed in a split-screen arrangement wherein the image and graphics 
layer 47 is displayed on one portion of the screen of the monitor 41 , and the 
semitransparent spreadsheet 46, which may be adjusted so as to no longer 
be transparent, can be displayed in another portion of the screen of the 
monitor 41 . Alternatively, the image and graphics layer 47 can be displayed 
on the screen of the monitor 41, and the semitransparent spreadsheet 46, 
which may be adjusted so as to no longer be transparent, can be displayed on 
the screen of a second monitor (not shown). 
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Fig. 5 shows the superposition combination of the contents of data display 
buffer 51 and the semitransparent spreadsheet overlay 52 to form a 
composite display 53. Not shown are the split-screen combination, and the 
dual-screen combination of the contents of data display buffer 51 and the 
semitransparent spreadsheet overlay 52. 

Figs. 6. 7. 8, and 9 illustrate the effect of spreadsheet cell selection on the 
underlying data display buffer. The contents of the underlying data display 
buffer changes in accordance with the particular cell that is currently selected. 
Also, the contents of the formula line changes in accordance with the 
particular cell that is currently selected. Note that only the data contents of 
the selected cell is displayed; all of the other data associated with the objects 
underlying the other cells remains invisible to the user. By contrast, all of the 
data in a standard spreadsheet is visible to a user, including a large standard 
spreadsheet, notwithstanding the need to scroll over the large spreadsheet. 

In monitor 61 of Fig. 6, spreadsheet focus (highlight) 63, indicated by the 
frame border (or any selection highlighting), is on cell A1. Formula line 62 
indicates that cell A1 is assigned the single method object ACQUIRE, which 
contains an image buffer resulting from its image acquisition method. The 
underlying data display buffer 64 shows the content of the image buffer 
associated with ACQUIRE. 

In monitor 71 of Fig. 7. spreadsheet focus 73 is on cell A2, indicating that 
cell A2 is selected. Formula line 72 indicates that cell A2 is assigned the 
single method object PROCESS which contains the image buffer that results 
from the processing a rectangular region 75 in the image associated with cell 
A1 . The other four arguments of the object PROCESS represent the 
coordinates of the upper-left corner, and the height and width, of the 
rectangular region 75 in the image associated with cell A1. The underlying 
data display buffer 74 shows the content of the image buffer associated with 
the processed image. 

In monitor 81 of Fig. 8. spreadsheet focus 83 is on cell A3. Formula line 
82 indicates that cell A3 in this example is assigned the single method object 
HISTEXTRACT which contains a histogram array extracted from a 
rectangular region 85 in the processed image assigned to cell A2. The other 
four arguments of the object PROCESS represent the coordinates of the 
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I 

I upper-left corner, and the height and width, of the rectangular region 85 in the 

I image associated with cell A2. The underlying data display 84 shows the 

I content of the input image buffer plus a graphical representation of the 

I histogram array associated with the content of the input image buffer. 

I In monitor 91 of Fig. 9, spreadsheet focus 93 is on cell A4. Formula line 

I 92 indicates that cell A4 in this example is assigned a contrast value 

I computed from the histogram array assigned to cell A3. The underlying data 

I display buffer 94 shows the content of the acquired image. 

I The forgoing illustrates how single method objects co-operate with a 

I variably transparent spreadsheet overlaid on the contents of a data display 

I 

I buffer so as to efficiently and elegantly extend the conventional spreadsheet 

I paradigm to accommodate images and other large data sets. 


Conditional Cell Execution 

Referring to Fig. 1 1 , a sequence of four instances 101 , 104, 7. 1 10 of a 
portion of an electronic spreadsheet incorporating the improvements of the 
invention is shown. In the first spreadsheet instance 101. cell B1 is selected 
by a user, and is seen to be equal to the logical constant FALSE. After a user 
selects a "cell state" display mode from a pull-down menu, selecting a cell or 
plurality of cells causes an enable dialog box 102 to appear as well as 
causing an associated logical switch expression pop-up window 103 to 
appear (also see Fig. 12. step 115). The enable dialog box 102. 
superimposed on the spreadsheet grid, shows that the enable switch 
expression is equal to the logical constant TRUE, indicating that the 
expression in B1 will be executed. It is also possible for the user to change 
the enable switch expression by entering a new enable switch expression 
1 1 5, as shown in Fig. 1 2. 

Thus, the value of B1 will be FALSE, provided that the enable switch 
expression that controls the execution of cell 81 is set to TRUE. The implicit 
conditional expression (including the enable switch expression) that controls 
the execution of cell 81 is shown in the pop-up window 103 that appears with 
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the enable dialog 102, and contains the logical expression: 
IF(TRUE,B1=FALSE). 

In spreadsheet instance 104. cell B2 is selected and conditionally set 
equal to the results of the expression evaluated in B3. based on the 
conditional expression in the pop-up window 106. Enable dialog 105 shows 
that the enable switch expression is equal to the result of expression 
evaluated in ceil 81. Since 81 is known to evaluate to FALSE, in this case, 
the expression in 82 will not be executed. The implicit conditional expression 
associated with cell 82 is shown in the pop-up window 106. 

In spreadsheet instance 107, cell 83 is selected and set equal to the 
result of an image measurement function performed on an external image 
data buffer Enable dialog 108 shows that the enable switch expression is 
equal to the logical constant TRUE, indicating that the expression in 83 will be 
executed. The implicit conditional expression associated with cell 83 is shown 
in the pop-up window 109. 

In spreadsheet instance 1 10. cell 84 is selected and set equal to the 
result of a logical operation performed on the results of the expressions 
evaluated in 82 and 83. Enable dialog 1 1 1 shows that the enable switch 
expression is equal to the logical constant TRUE, indicating that the 
expression in 84 will be executed. The implicit conditional expression 
associated with cell 84 is shown in the pop-up window 1 12. 

Referring to Fig. 1 1 , a BASIC program fragment 113 shows the BASIC 
program steps that together are equivalent to the electronic spreadsheet 
program shown In Fig. 10. One skilled in the art can observe that this BASIC 
program will exhibit the same behavior, i.e.. evaluate expressions, assign 
values, and transfer program control, so as to achieve the same result as the 
execution of an improved electronic spreadsheet according to the invention, 
yet via an entirely different user interface. Fig. 1 1 emphasizes and illustrates 
that the improved electronic spreadsheet of the invention can achieve 
functionality that was previously not possible in electronic spreadsheets, and 
prior to the invention, was possible only using computer languages like 
BASIC. COBOL, FORTRAN, and C, for example. 

In the forgoing description of Fig. 10, a spreadsheet is programmed to 
behave in one of two possible ways, depending on cell 81. If the expression in 

26 


S wo 01/11445 PCTAJSOO/22383 

I • 

^ cell B1 is set to TRUE (thereby indicating that the spreadsheet is in training 

I mode in the example of Fig. 10), the spreadsheet executes a training 

^ sequence whereby the results of an image measurement executed in cell B3 

I are saved in cell B2 for future comparisons. 

I If the expression in cell 81 evaluates to FALSE (thereby indicating testing 

I mode in the example of Fig. 10). the training step associated with the 

I expression in cell 81 is not executed. The expression in cell 84 goes on to 

[ perform a test which compares the current image measurement performed in 

r 83 to the measurement saved on the most recent training cycle in cell 82. 

I Figure 13 depicts the spreadsheet main loop. At the start of processing, as 

I indicated by the start bubble, the function calls the DisplaySheet function to 

I display the contents of the spreadsheet. It then waits for one of six input 

I conditions: Move Up. Move Down. Move Left. Move Right. Edit Cell, and 

Escape. It responds to any of the first four conditions by testing the current 
row or column count and incrementing or decrementing the respective one of 
these, all as indicated in Fig. 13. The program responds to an Edit Cell input 
condition by awaiting an input, testing the validity of the command, and if the 
comand is valid, then calling the Update CellCmd and EvaluateSheet function, 
I as shown. The program responds to an Escape input by quitting. 

I Figure 14 depicts the DisplaySheet function. As shown here, the program 

j initializes and increments the indices i and j in order to loop through the rows 

■ and columns, respectively, of the spreadsheet For each combination of 

those indices within the spreadsheet, the program calls the Print Value 
function in order to display a cell at the location p][j]. A test is performed 
during the inner loop to determine whether a location i and j points to the 
current row and column respectively and. if so, to highlight the cell (via the 
function Highlight Cell) prior to invoking the Print Value function. 

Figure 15 depicts the EvaluateSheet function. At the outset, this function call 
the EvaluateCell function. Thereafter, as in Figure 14. the EvaluateSheet 
function initializes and increments the indices i and j in order to loop through 
the rows and columns, respectively, of the spreadsheet. The inner loop here, 
rather then invoking the aforementioned Print Value and Highlight Cell 
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functions, tests CellCmd[i][j] for dependency on CellVal[u][v]. If so. it calls the 
EvaluateSheet function. OthenA/ise. ft proceeds to the next row and column, 
all as clearly shown in Fig. 15. 

Figure 16 depicts the aforementioned EvaluateCell function of Fig. 15 which, 
at the onset, includes invoking the Split CellCmd[i]0] with the indicated 
command and arguments. Thereafter, the function evaluates arguments Arg1 
-> Vail . Arg2 -> Val2, and so forth, as indicated. The function then executes 
one of the five respective commands: SET, ADD. MUL, SORT, and DEL, as 
shown. The SET command results in the cell value being set to Val1. as 
shown. The Add command, results in the cell value being set to the sum of 
Vail and Val2. Likewise, the MUL command results in the call value being 
set to the multiplicative product of Vail and Val2. The SQRT command 
results in the cell value being set to the square root of Vail . The DEL 
command results in the cell value being set to zero and command being set to 
NULL. Following execution of the indicated command the function returns. 


Spreadsheet with Extensions 

Spreadsheet processing begins in the Main Loop, shown in Fig. 17. The Main 
Loop allocates storage and assigns variables to represent data storage of 
dimension N by M where. N is the number of rows in the spreadsheet, and M 
is the number of columns. The array element Fomaula[u][v] identifies storage 
for the spreadsheet formula assigned to the (u.v) coordinate of the grid. The 
array element Data[u][v] identifies storage for data associated with the output 
of Fonnula[u][v]. The local variables Row and Col identify the active cell. The 
active cell is the spreadsheet cell that has the current user interface focus and 
is the implicit target of editing and special display operations. 

After entering at the start bubble, the DisplaySheet function is called to 
displays the contents of the spreadsheet. The program then waits for one of 
four input conditions: Move, Edit, Trigger, or Escape. The Move condition 
indicates that the user wants to change the coordinate of the active cell. The 
Update function updates the row and column coordinate of the active cell 
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I within the spreadsheet grid. The Edit condition indicates that the user wants to 

I modify the fomriula associated with the active cell. The EditCell function is 

I called to assigns a new formula to the active cell. The ExecuteCell function is 

I called to updates the data associated with the active cell and all dependent 

I cells. The Trigger condition indicates that an external event has occurred. The 

( ExecueTrigger function is called to locate and execute all cells within the 

I spreadsheet dependent on that event. 

I After handling Move, Edit, or Trigger conditions the main processing loop is 

\ restarted. The Escape condition indicates that the user wants to terminate the 

I main processing loop and exit the spreadsheet program. 

I The DisplaySheet function, shown in Fig. 18, is called from the Main 

\ Loop to displays the contents of the spreadsheet. Special emphasis given to 

I information associated with the cell at focus coordinates (u,v). On entering 

\ DisplaySheet the DisplayData function is called to handle special display 

I requirements associated with any large data sets that may be assigned to the 

j cell at the focus coordinates. The conventional spreadsheet grid is then 

displayed by looping through the cell array and, for each cell, calling the 
DispiayCell function. When the temporary grid coordinates (1 j) are equal to 
the focus coordinates (u,v) the function HighLightCell is called to highlight 
that position in the spreadsheet grid. Before return, theDisplayFormula 
function is called to display the formula assigned to the focus cell. 

The DisplayData function, shown in Fig. 22, is called from 
DisplaySheet to manage the graphical display of large data sets contained 
within the cell at grid coordinate (u,v). The function compares the cell formula 
with formulas that output large data sets. If a match is found the 
corresponding data display function is called. For example, if the cell has 
been configured to acquire an image, the Displaylmage function is called to 
display the acquired image data. Similarly, if the cell has been configured to 
compute a histogram. The DisplayHist function will be called to display the 
accumulated histogram. 

The DispiayCell function, shown in Fig. 23, is called from 
DisplaySheet to control the representation of cell data in the conventional 
spreadsheet grid. The function compares the cell's formula to determine the 
type of data stored at (u,v). If the data is a conventional scalar value, that 
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value is displayed at the cell's (u,v) grid location. If the cell contains extended 
data, the name of the stored data type is displayed ceirs (u,v) grid location. 
For example, if the cell has been configured to acquire an image, the text 
string "IMAGE" is displayed. Similarly, if the cell has been configured to 
compute a histogram the text string "HIST will be displayed. 

The EditCell function, shown in Fig. 19, is called from the Main Loop 
to inputs formulas to be assigned it to the cell at coordinates (u,v). The 
formula is first tested for valid syntax and argument type. If valid the 
DeleteCeil function is called to release storage associated with the old 
formula. The old formula is then replaced by the new formula and the 
AllocCell function is called to allocate and initialize the necessary data 
structures. 

The AllocCell function, shown in Fig. 28, is called from EditCell to 
manage the allocation and initialization data. The function compares the 
return type of the formula at (u,v) with extended data types. If a match is 
found the corresponding data allocation function is called andData[u][v] is 
assigned a reference to the allocated storage. For example, if the cell's 
fonmula returns image data, the Alloclmage function is called to allocate and 
initialize memory storage locations associated with image data. Similarly, if 
the formula is determined to return histogram data, the AliocHist function is 
called to allocate and initialize storage appropriate to the storage of 
histograms. 

The DeleteCeil function, shown in Fig. 29, is called from EditCell to 
manage the de-allocation of cell data. The function compares the return type 
of the formula at (u,v) with extended data types. If a match is found the 
corresponding data de-allocation function is called to release the storage 
referenced by Datalul[v]. For example, if the cell's formula returns image 
data, the Deletelmage function is called to de-allocate memory storage 
location associated with image data. Similarly, if the formula is determined to 
return histogram data. theDeleteHist function is called to de-allocate data 
storage associated with the array. 
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The ExecuteCell function, shown in Fig. 20. is called by the Main 
Loop and, recursively, by ExecuteDependentCells. The ExecuteCell 
function calls theExecutueFormula function to update the contents of 
Data[u][v]. and the ExecuteDependentCells function to force the update of 
all cell dependent on Data[u][v]. 

The ExecuteFormula Function, shown in Fig. 24, is called by 
ExecuteCell to manage the evaluation of the cell fomnula at spreadsheet grid 
coordinate (u,v). The function views the formula in three parts: the switch 
expression, the command instructions, and the arguments. If the switch 
expression evaluates TRUE, the values of arguments are resolved, and a 
determination is made as to whether the cell is conventional or extended. If 
the cell contains a conventional spreadsheet formula returning a simple scalar 
the ExecuteConventional function is called to complete the evaluation of the 
cell's value. If the formula results in a large data set. such as an image or a 
histogram, the ExecuteExtended function is called to complete the evaluation 
of the ceirs internal data structure. 

The ExecuteConventional Function, shown in Fig. 26. is called from 
ExecuteFormula to manage the evaluation of conventional spreadsheet 
commands. The input command is compared with a list of valid commands, if 
a match is found the corresponding operation is executed updating the cells 
data value. For example, the conventional spreadsheet conditional command 
"IF" interprets the first argument as a condition by which to decide whether to 
set the cell's Data[u][v] to either the second or third argument. Similarly, the 
command "ADD" causes Data[u][v] to be set to the sum of the first and 
second arguments. 

The ExecuteExtended Function, shown in Fig. 27, is called from 
ExecuteFormula to manage the evaluation of extended spreadsheet 
commands. The input command is compared with a list of valid commands, if 
a match is found the corresponding operation is executed updating the cells 
data value. For example, the "ACQUIRE" command invokes the Acquire 
function, which causes a new image data to be copied from an external 
source to the storage location identified by the cell's Data[u][v] variable. 
Similarly, the "HIST* commands invokes the Histogram function which 
causes a histogram of the image data identified by first argument to be 
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computed. The histogram array is stored in the locations identified by the 
cell's Data[u][v] variable. 

The ExecuteDependentCells Function, shown in Fig. 25. is called by 
ExecuteCell and by ExecuteTrigger. The ExecuteDependentCells function 
locates and executes spreadsheet cell whose output is a function of the data 
stored in the cell located at spreadsheet grid coordinate (u,v). This function 
searches the spreadsheet for cells whose input expressions reference the cell 
I 3t ("'V)- a match is found, a test is made to determine is the reference is 

circular, that is, if the formula is ultimately dependent on itself. If the reference 
is detemnined to be noncircular, the ExecuteCell function is called to execute 
the dependent cell. Note that the call to ExecuteCell is recursive, since 
ExecuteCell will call ExecuteDependentCells to evaluate subsequent 
dependencies. 

The ExecuteTrigger function, shown in Fig. 21 . is called from the Main Loop to 
search the spreadsheet for a trigger fomiula. If a matching trigger cell is found, its 
Data[i][j] variable is set TRUE and function ExecuteOependentCelis is called to 
update any dependent cells. After all dependent cells have been executed the trigger 
cells value is set back to FALSE, to prevent the asynchronous execution of cells with 
explicit trigger dependencies. 

Further understanding of the illustrated embodiments may be obtained by 
reference to the Appendix filed herewith, which discloses preferred methods 
and apparatuses for machine vision interfaces and environments. 

Other modifications and implementations will occur to those skilled in 
the art without departing from the spirit and the scope of the invention as 
claimed. Accordingly, the above description is not intended to limit the 
invention except as indicated in the following claims. 
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CLAIMS 

What is claimed is: 

1. A user interface for programming machine vision applications, comprising: 

an image window for displaying an image to be analyzed; 

a spreadsheet for analyzing the image, displayed with the image window. 

2. The user interface of claim 1 , further comprising: 

a control pad, at least for navigating over the spreadsheet. 

3. The user interface of claim 1 , further comprising: 

a plurality of menus having various software tools, 

4. The user interface of claim 1, further comprising: 

a palate of alpha-numeric characters for input into the spreadsheet. 

5. The user interface of claim 1. wherein the spreadsheet is semi-transparent, 
such that the image can be seen through the spreadsheet. 

6. The user interface of claim 1, wherein the spreadsheet is adapted to 
perform conditional cell execution. 

7. The user interface of claim 1 . wherein the spreadsheet includes functions 
that can operate on values stored over an interval of time. 

8. The user interface of claim 2, wherein the control pad indicates a particular 
cell of the spreadsheet, thereby resulting in a change in the appearance of the 
image displayed. 

9. The user interface of claim 1. wherein the spreadsheet includes cells 
adapted to buffer outputs, thereby providing circular reference for recursive 
operation. 
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10. The user interface of claim 1, wherein the spreadsheet includes cells that 
can be assigned arbitrary depth in a time dimension. 

11. The user interface of claim 1, wherein complex vision objects are 
instantiated as a single cell in the spreadsheet, the single cell having data that 
is accessible through a plurality of member functions. 

12. The user interface of claim 1. wherein th€) spreadsheet includes cell that 
are adapted to store two dimensional image arrays that result from image 
processing operations. 

13. The user interface of claim 1. wherein the spreadsheet includes image 
buffers used for intermediate processing, the image buffers being 
automatically released once dependent operation are satisfied. 

14. The user interface of claim 1 , further comprising: 

a spreadsheet mask for obscuring portions of the spreadsheet, leaving 
portions unobscured that can be used to control operation of the spreadsheet. 

15. An electronic spreadsheet for processing a continuous data stream, the 
electronic spreadsheet having a plurality of cells, the improvement 
comprising: 

a clocked delay line object, the clocked delay line object being 
instantiated and assigned to a cell of the electronic spreadsheet; 

an external data input function adapted to provide a clock signal to the 
clocked delay line object; and 

a spreadsheet function adapted to provide random access to data stored 
in the clocked delay line object. 
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16. The electronic spreadsheet of claim 15, wherein the clocked delay line 
object is parameterized by a plurality of arguments, including: 

an input data stream; 
a clock source; 

a number of elements in a shift register buffer; and 
a clock divider. 

17. The electronic spreadsheet of claim 15. wherein the clocked delay line 
object further includes: 

a method for clocking data; and 

a method for access to data stored in the clocked delay line 
object. 

18. The electronic spreadsheet of claim 15. wherein the clocked delay line 
object is adapted to trigger the execution of the shift register function of the 
delay line object upon receipt of a clock signal provided by the external data 
input function. 

19. The electronic spreadsheet of claim 15, further including a spreadsheet 
function that performs analysis of a data interval stored in the clocked delay 
line object. 

20. A method for using an electronic spreadsheet for processing continuous 
data streams over an interval of size greater than one, the method 
comprising; 
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instantiate and assign a dockable delay line object having 
data storage to at least one cell of the electronic spreadsheet; 

provide a clock signal to the delay line object; 

randomly access the data storage over an interval of size 
greater than one; and 

process the data so-accessed. 

21 . A method for processing continuous data streams over an interval of size 
greater than one using an electronic spreadsheet having clocked delay line 
objects instantiated in the cells of the electronic spreadsheet, each delay line 
object having a delay line buffer, a source of clock signals, and spreadsheet 
functions that support selectable access to data stored in a delay line of the 
clocked delay line object, the method comprising: 

assign to a first cell an external input function adapted to 
access a data source external to the spreadsheet; 

assign to a second cell an instance of a delay line object; 
assign to a plurality of cells a respective plurality of tap 
functions, each tap function adapted to access the delay line 
buffer of the delay line object at a selectable clock cycle to provide 
a respective plurality of data elements stored in the delay line 
buffer; and 

assign to at least one cell a function adapted to process the 
plurality of data elements upon each clock cycle. 
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22. An electronic spreadsheet having a plurality of cells, the improvement 
comprising: 

a single method object, adapted to be instantiated in at least one 
of the spreadsheet cells, and adapted to provide Internal storage and 
member functions, the member functions being adapted to access the 
single method object and return a single value; 

a data display buffer, the data contents of which are displayed 
under a variably transparent spreadsheet grid; and 

means for selectively displaying the data content of the single 
method object in the data display buffer corresponding to a selected 
spreadsheet cell. 

23. A method for selectively displaying large data sets in an electronic 
spreadsheet having a plurality of cells, the method comprising: 

instantiating a single method object in each of a plurality of the 
cells of the spreadsheet, each single method object being adapted to 
provide internal storage for storing a large data set; 

displaying the large data set of the single method object 
corresponding to a selected cell of the spreadsheet; and 

displaying in superimposed relationship with the large data set a 
variably transparent spreadsheet including the selected cell. 

24. A user-interface method for selectively displaying machine vision images 
stored in an electronic spreadsheet having a plurality of cells, the method 
comprising: 

37 


wo 01/11445 


PCT/USOO/22383 


instantiating a single method object in each of a plurality of the 
cells of the spreadsheet, each single method object being adapted to 
provide internal storage for storing a machine vision image; 

selecting a cell from the plurality of cells; 

displaying the machine vision Image stored in the single method 
object conresponding to the selected cell; and 

displaying in superimposed relationship with the machine vision 
image a transparent electronic spreadsheet including the selected 
cell. 

25. The user-interface method of claim 24. wherein the transparent electronic 
spreadsheet is adjustably transparent. 

26. The user-interface method of claim 24, wherein the selected cell is 
selected using a hand-held controller 

27. The user-interface method of claim 24, wherein the selected cell is 
selected using one of a standard keyboard and a mouse. 

28. The user-interface method of claim 24. wherein the machine vision image 
includes a superposition of an object image, and a graphical representation of 
an analysis of the object image. 

29. The user-interface method of claim 28, wherein the analysis of the object 
image is a histogram of the object image. 
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30. An improved electronie spreadsheet having a plurality of cells, each cell 
having an executable expression, the improvement comprising: 

for each cell of said plurality of cells, a cooperative implicit 
conditional execution wrapper having a logical switch expression, the 
implicit conditional execution wrapper combining the executable 
expression with the logical switch expression so as to enable or 
disable the executable expression of the cell in accordance with the 
value of the logical switch expression. 

31 . The electronic spreadsheet of claim 30. further comprising; 

a user interface for selecting a cell or range of cells. 

32. The electronic spreadsheet of claim 30, further comprising: 

a user interface for assigning a logical switch expression to an implicit 
conditional execution wrapper. 

33. The electronic spreadsheet of claim 30, wherein the logical switch 
expression is a legal spreadsheet expression that can be evaluated to logical 
TRUE or logical FALSE. 

34. The electronic spreadsheet of claim 33. wherein if the logical switch 
expression evaluates TRUE, the cell's con-esponding expression is evaluated, 
a new result value is returned, and the cell's internal result buffer is updated. 
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35. The electronic spreadsheet of claim 33. wherein if the logical switch 
expression evaluates FALSE, the cell's expression is not evaluated, and the 
cell's result buffer is returned unmodified. 

36. The electronic spreadsheet of claim 33. wherein individual switch 
expressions are initialized to a constant logical TRUE. 

37. The electronic spreadsheet of claim 31. wherein the user interface 
includes an interactive assignor that interactively assigns a switch expression 
to any cell or range of cells within the spreadsheet. 

38. The electronic spreadsheet of claim 30, wherein the user interface 
includes a cell selector that selects an arbitrary set of cells, and an interactive 
assignor that selectively assigns a logical switch expression to each set of 
cells so-selected, so as to program a desired behavior. 

39. A method for programming conditional execution of program statements 
in an electronic spreadsheet having a plurality of cells, the method 
comprising: 

associating an implicit conditional execution wrapper with each cell; 
selecting at least one cell; and 

entering a logical switch expression into the implicit conditional 
execution wrapper associated with the selected at least one cell. 


40 


|> MSDOCID: <WO 0111445A2J 


\ wo 01/11445 PCT/USOO/22383 

t 
b 

i 40. An apparatus for programming conditional execution of program 

i 

j Statements in an electronic spreadsheet having a plurality of cells, the method 

^ comprising: 

I means for associating an implicit conditional execution wrapper with 

I each cell; 

I 

I means for selecting at least one cell; and 

[ means for entering a logical switch expression into the implicit 

I conditional execution wrapper associated with the selected at least one 

I cell. 
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Insight) Guide and Reference 


In-Sight version J.O 


Welcome to In-Sight™, a compact, easy-to-use, stand-alone intelligent vision sensor for imiustrial machine 
vision, process control, and factory automation applications. In-Si^ can perfomi inspection, identification, 
measurement, and other similar tasks. It is, in many respects, a dedicated, freestanding vision computer. 
About the size of a paperback book, it performs all of its own processing. It can acquire images, di^iay 
tfiem, control ligjits, and communicate with external devices. Its innovative spreadsheet interface and built-in 
vision software greatly sinplify the task of developing and maintaining vision ^plications. 


For detailed information, open one of these topics: 


Introduction 

Usbm the Control Pad 

Modes 

Woricing with Imaizes 
Worksheet and Vision 
Using the In-Sight Server 
Clocked Data 
Geometry 
Image Processing 
PatFind^^i 
Text Functions 
Release Note 


Installmg In-Sight 

Using the In-Sidit Interface 

Working with Jobs 

Using the Worksheet 

Setting Options 

Image Acquisition 

Coordinate Transfomis 

Graphics 

Input/Output 

Structures 

Vision Data Access 


Getting Started 

Onlijie and Offline 

Saving Settings 

Building Fonnulas 

Building an Operator Interface 

Blob Analysis 

Edge Detection 

Histogram Analysis 

Mathematics 

System Functions 

Hardware Reference 


• Glossary 

NOTE This is a rough draft Its content is incon:q>lete, inaccurate, and unreviewed. It should give you the 

flavor of the forthcoming document, but you can rely on it only approximately. 
NOTE This confidential document is for Cognex internal use only. The infomfiation provided here is subject 

to change without notice. Do not circulate without proper authorization from the program manager. 

Please report any bugs, problems, or concerns about the hardware, software, or documentation to 

Tom Baker at the Portland office by internal email. 


^ A ► Intro: Overview 

These topics offer introductory information about In-Sight: 


What is the In-Sight Vision Sensor? 
Features and Capabilities 
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• Vision Functions 

• Pcveloping and Deploying Applications 

• Core Vision Processing Steps 

• Customer Supiwrt . 


^ A ► Intro: What is In-Sight? 

The Cognex In-Sight vision sensor is a low-cost, easy-to-use, stand-alone intelligent camera designed for 
industrial machine vision, process control, and fectory automation ^plications. It can perforai inspection, 
identification, measurement, and other similar tasks. It is, in many respects, a compact, dedicated, 
freestanding vision computer. About the size of a paperback book, it perfomis all of its own processing. It 
can acquire images, display them, control lights, and communicate with externa! devices: 

Power (24 VDC) 
Power Indicator LED 
Reset switch 



Unlike vision systems based on frame grabbeis, bi-Sight can operate independently, without a host PC, 
monitor, or keyboard. UnUke traditional sensors— photocells and the like^it offers sophisticated vision 
processing algorithms and significant computational power. In-Sight bridges the gap between sensors and 
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computers and offers the reliability required on the real-world factory-floor. 

In-Sight is easy to configure and reconfigure. Instead of conventional programming, it has a spreadsheet with 
built-in image processing functions. Instead of a keyboard, it has a Control Pad, similar to the game pads 
used with video games. When setting up an application, you attach a monitor and a Control Pad, viewing an 
image to set ^> image acquisition, image processing, feature extraction, and so on. In a finished application, 
you can remove the monitor. Control Pad, or both and run the In-Sight sensor as freestanding device. 
In-Sight then receives commands and sends resuJts via its I/O and RS-232 interfaces. 

Setting up In-Sight requires a knowledge of the relevant manufacturing process but does not require a deep 
immersion in vision processing. Typical In-Sight ta^ irKlude gciuging dimensions, locating parts, inspecting 
assemblies, and so orL 



^ A ► Intro: Features and Capabilities 

• Standalone operation. No PC required for setup or run-time. 

• Straightforward gninhical interface run through an eight-button Control Pad . Reflecting tfie factory 
floor environment, this pendant controller lets an operator run tfie system even while standing, wearing 
gloves, away fi:'om a desk, or away fi^m a monitor. 

• Spreadsh eet-based vision processing interface — drawn directly on the image, with adjustable 
transparency — for easy configuratioiL In-Si^t presents con^lex image data and results through 
worksheet cells as simple scalar values that can be manipulated with conventional spreadsheet 
functions. 

• Built-in fimctions for constructing worksheet formulas: 

o Featiire-extraction and image analysis techniques including blob analysis, edge detection, 
pattern matching, geometric measurement, histogram analysis, coordinate transforms 
(calibration), and so on. 

o Image-processing operations including neighborhood filters (high pass, low pass, erode, dilate, 
open, close, tophat, and bothat) and point filters (binarize, clip, equalize, and stretch). 

o Image comparison, which checks an ROI against a template and creates a result image that 
highlights the differences between the ROI and the template. 

o Mathematical functions and operators, providing a full range of standard arithmetical, 
conditional, logical, statistical, and trigonometric operations. 

o Text functions, to manipulate text strings for display or serial communications. 

• Clocked d ata fimctions. used to iiK:rement a value or to delay an ou^ut signal for a specified time, 
typically to wait for an inspected item to reach a piece of equipment triggered by the output signal. 

• Graphics drawn on the display. Available graphics include: 

o Charts, used to monitor the history of a value. 

o Controls dravwi on the worksheet such as buttons, list boxes, and check boxes, commonly 

used to build an operator interface, 
o Geometric shapes drawn on the image. 

• Fast, compact hardware, purpose-built for image processing. Inchides 4 MB of flash memory (for 
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nonvolatile job and program storage) and 1 6 MB SDRAM (for nin-time processing and image 
acquisition). 

. Industrial packaging: mgged cast-aluminum enclosure; no moving parts such as fans or disk drives; ? 
flanged? attachmait points for horizontal or vertical mounting. 

Dit?tal camera producing a high^juality 8-bit 640x480 image. Offers rapid reset, progressive scan, 
ftdl-fiame integration, and a C-mount lens. 

Dynamic light control for one or two exteroal variable-intensity lights, each with one or two light 
banks. 

Versatile I/O: 

o Two RS-232C serial ports, 

o Ten discrete inputs and ten discrete outputs, for general-purpose use. 

o On-camera trigger input and strobe output 
Server program that runs on a Windows PC, to save images and archive jobs over the serial port 
Includes a tenninal program with commands to acquire images, run jobs, get and set cell values, and 
so on. 

Standard 15-pin DIN connector for a VGA monitor or a compatible flat-panel LCD display. 


^ A ► Intro: Vision Functions 

The hfi-Sight software includes built-in vision processing filiations, mathematical functions, and operators, all 
used to build formulas in the In-Sight woiicsheet. The categories are: 

Category DescripHon 

Acquisition The Acquirelmagc function acquires an image and stores it in an Image structure in cell 

$A$0. It also sets values that control the lights and camera including trigger source (manual, 
continues, on-camera, discrete I/O, or serial, and so on), the first scan line to acquire, the 
number of scan lines to acquire, and video gain and ofTset. 

Blob Analysis Finds, analyzes, and classifies blobs, which are contiguous patches of pixels on one side of a 
grayscale threshold Blob analysis — also called connectivity analysis — ^provides data about 
tiie number, location, shape, and orientation of blobs. Vision applications use blob analysis 
for feature extraction, especially for features defined by generalized criteria such as an area 
or perimeter range. 

In-Sight's blob functions, listed under Vision Processing in the Fonnula Builder offer 
automatic thresholding and the ability to select blobs by color, size, area, and other 
characteristics. 
Clocked Data Offers time-related functions that: 

• Keep various kinds of running totals. 

• Store a value over a time interval, for example to delay an ouq)ut signal to synchronize 
it with a device deeper in the production line. 
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Maps between coordinate systenns. The Formula Builder lists three kinds of transformations: 


• Calibrate. Establishes a coordinate transformation between two planes. Often used 
to create a calibrated transformation, which converts in either direction between image 
locations (in Pixel coordinates) and physical locations (in World coordinates). For 
example, an application might convert points and distances from row-and-column 
pixel values to real-world units such as millimeters or inches. To simplify the process 
of converting feature extraction and measurement results, In-Sight offers functions that 
convert entire structures in one step. 

Although through-the-lens calibration is a common use for coordinate transformation, 
you can use In-Si^t's calibration functions for other plane-to-plane transforms. 
Because In-Sight computes the transform from four known points, the two coordinate 
systems can be skewed. 

• Fixture. Converts between a reference (Fixture) coordinate system and either World 
or Pbcel values. A fixture is a reference coordinate system (X, Y, theta) located in an 
image and used to define other locations through offsets, typically to compensate for 
image-to-image variation in position, orientation, or both. 

• Warp. Maps a point in a warped image back to its location in the original, unwarped 
image. (Waiplmage, under Vision Processing, constructs the warped image.) 

Edge Detects straight or curved edges, each marked by a light-to-dark or dark-to-light transition 

Detection with a specified width and strength. Vision applications use edge detection to extract and 
measure linear features. 

In-Sight's edge-detection functions, listed under Vision Processing, offers methods for 
filtering false edges, excluding uninteresting edges, and sorting them in various orders. For 
straight edges or edge pairs, In-Sight measures the distance between the edges. For circular 
or curved line edges, In-Sight measures the radius. 
Geometry^ Measures distances and angles and constructs geometric shapes. Categories are: 

• Measure: gauges distances and angles of points, lines, and circles in various 
combinations. These basic geometric measurements are cmcial for many inspection 
applications, which use them to check the dimensions and locations of parts. 

• Fit: constructs geometric shapes. 

Graphics • Draws graphics on the iniage including arcs, circles, lines, and regions. 

• Adds graphic controls to the worksheet such as buttons, check boxes, and list boxes. 
You typically use these controls to perinit operator input in the deployed application. 
They remain active even when you lock the woricsheet. 

• Di^lays charts (which plot the history of a value, to determine correct parameter 
settings, or for process monitoring) and a status indicator (color coded for 
Pass/FaiJAVaming). Both are commonly used to operator output in the deployed 
application. 


Coordinate 
Transforms 
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Histogram 
Analysis 


Image 
Processing 


Counts grayscale values from an image region and plots their grayscale distribution Values 
emitted to the woricsheet include an automatically computed binary threshold (the grayscale 
value that best separates the image into light and dark regions) and averages for the light 
region, daric region, and entire histogram. Statistics available for all or part of the histogram 
include the number of pbcels, the first and last non-zero gray level (head and tail), the most 
and least common gray levels (maximum and minimum), the sum, and the standard deviation. 
Vision apphcations commonly use histograms for image analysis or feature extraction. Listed 
under Vision Processing. 
Collects operations that yield an image result: 

• Image Processing, which offers neigborhood filters (high-pass, low-pass, erode, 
dilate, open, close, tophat, bothat, edge direction, and edge magnitude) and point 
filters (binarize, clip, equalize, stretch). 

• Image comparison, v/hich con^ares an image with a ten^Iate to detect their 
diffCTences. A common use is detecting anomalies in inspection ^plications. 

• Warping, a polar transformation that unwraps a curved or circular feature into a 
second, rectangular image. (Coordinate Transfomis has a fiinction that maps a point in 
die warped image back to the corresponding location in the original image.) 

Input/Output Reads and writes to external devices through discrete I/O or the serial ports. 
Mathematics Lists mathematical functions and operators in the following groups: 

• Logic: logical AND, OR, and NOT; also range checking. 

• Lookup: finds values in lists. Includes IfQ, for conditional formulas. 

• Math: arithmetical functions— absolute value, exponent, random number, square rx)ot, 
sum, and so on. 

• Operators: Mathematical, logical, and relational operators. Their precedence is the 
same as ANSI C. 

• Trigonometry: Cos, Sin, Tan, Pi, Radians, and so on. 

• Statistics: Maximum, Mean, Minimum, and Standard Deviation. 


PatFlncP^^ 


Performs pattern-matching searches after building model. In-Sight supports two kinds of 
model, edge-based and area-based: 

• An edge model extracts geometric boundaries fix)m an image region and uses them to 
find instances of the uKxlel in an image. Edge models tolerate variations in rotation, 
scale, and image intensity; they also tolerate partial occlusions. 

• An area model extracts specified image area to use as a template. It then measures the 
similarity between the t^plate and a series of image regions through normalized 
conelation, evaluating grayscale diflFerences on a pixel-by-pixel basis. An area model 
tolerates variation in rotation and scale. 

Vision applications use pattern matching for feature extraction, particularly for features that 
are stable in size and shape. The PatFind functions are hsted under Vision Processing. 
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Structures 


Text 

Functions 


Vision Data 
Access 


Creates storage for fixtured circles, cross marks, points, or regions. All of the values that 
define the structured item reside in a single cell, instead of consuming one cell each, 
simplifying the worksheet Some applications define structures for "global" items, since 
changing a value in a structure changes it in all formulas that refer to it 
Manipulates text strings. For example, finding text within a string, replacing text in a string 
with new text, converting a string to lowercase or UPPERCASE, comparing two strings, and 
so oa Common uses are manipulating strings for serial communications or for on-screen 
display. 

Gets individual values fiom the structures generated by vision fimctions. Each category — 
Blobs, Edges, Hist, and so on — lists the subset of result functions available for that structure. 


Irv^ight) 


^ A ► Intro: Develop and Deploy Applications 

The In-Sight vision sensor has many ^plications in inspection, quality control, and factory automation. A 
typical application starts off in an office or lab environment and then moves to the fectory floor for integration 
and testing. After connecting and adjusting all of the parts of the system — including the vision prxx:essing 
equipment, the mechanical subsystems, and so on — ^the In-Sight hardware runs continuously in the 
production environment If desired, you can lock In-Sight's configuration to prevent unauthorized change. 
The following figure shows a pitxluction line with an In-Sig^t system: 



The exact development steps depend on the task at hand. A typical sequence might be: 

1 . Install the In-Sight system on a test stand. Add other equipment such as a monitor, a trigger source, 
and so on. 

2. I>etennine the requirements of the vision applicatioa Preliminaiy steps might include reviewing quality 
control and inspection specifications, interviewing production personnel, evaluating I/O requirements, 
evaluating operator interface requirements, and generally understanding the manufacturing context. For 
an inq^ection application, for example, it is important to fiilly characterize "good" parts, 'Tjad" parts, 
and the differences between them. 

3. Select a C-mount lens . The focal length usually depends on the desired field-of-view and working 
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distance: 

o Field-of-view is the area seen tiirougji the lens. In general, it must be large enough to resolve 
the features of interest including an adequate positional tolerance — but small ^ough to avoid 
wasting resolution on unimportant objects. 

o Working distance is the separation between the camera and the object Physical or mechanical 
constraints often influence the working distance. For the same field of view, increasing the 
working distance requires increasing the focal length of the lens, reducing depth of field. 
Sometimes you can use mirrors or prisms to improve camera placement. 

For more infonnation, see Selecting a Lens . 

4. Select lighting. Lighting technique plays a veiy large role in an application's success. Considerations 
include: 

o The light level must be hight enou^ to illuminate the features of interest at the working 
aperture and shutter speed You can sometimes compaisate for insufficient hght by increasing 
aperture or gain, but providing adequate light is almost always the first-choice solution for 
solving exposure problems. 

o The type of light must be appropriate for the features of interest and the purpose of the 

application. Light can be white or colored, diffuse or directional, on-axis or off-axis, obbque or 
perpendicular, unidirectional or omnidirectional, continuous or strobed, and so oil The wide 
range of choice makes it difficult to offer generalized suggestions, but it is vitally important to 
select lights that makes the important details prominent in the image. 

For more information, see Li&htin^ Guidelines and Lif^htine Techniqttes. 

5. Collect representative "good" and "bad" part samples, and acquire a set of test images. The 
acquisition settings detemMne exposure; one strategy is to adjust the lights and image sensor to place 
the features of interest near the center of the grayscale range, seeking the highest-contrast image that 
does not saturate the brightest or darkest values. 

6. Set up a worksheet that performs the necessary vision processing. Image-related operations include: 

o Image processing operations such as filters, image warping, and image aritiimetic. 

o Feature extraction operations such as blob analysis, edge detection, and pattern matching. 

o Feature analysis operations such as histograms, distance measurement, and angle measurement 

A common goal at this stage is to obtain reliable results in a lab environment. For a representative 
sequence of processing steps, see Core Vision Processing Steps. 

7. Most In-Sight applications communicate with other production equipment through serial I/O, discrete 
I/O, or both. Depending on the source of the acquisition trigger, data signals from other equipment, 
and the method for communicating results, you configure the worksheet for the necessary processiiig: 

o For serial communications with a PC or other serial devices— typically to receive commands, 
return results, or archive jobs — connect the device to one of the Vision Processor's serial ports 
and configure In-Sight for its baud rate, parity, and so on. To manipulate strings read or written 
to a serial port, use In-Sight's text functions. 

o If your application uses discrete I/O— typically to signal PLDs and other production 

equipment— then connect I/O through twisted pair or other suitable wiring. Next, configure the 
worksheet to read or write the associated bits and respond appropriately when they change 
state. To delay an output signal, typically to wait for an inspected item to reach a piece of 
equipment triggered by the signal, use In-Sight's DeiayLineQ fiinctioa 
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It is not always practical to develop the I/Orelated processing in a lab environment, away from the 
actual production equipment. 

8. If desired, construct an operator interface . In-Sight lets you put buttons or other graphical controls in 
cells for end-user input or output It also lets you sirrqjlify, customize, or hide the woiicsheet. When 
designing the interface, it can be helpful to seek feedback from the technicians who will run the 
system. 

9. Save the job to flash memory. 

10. Move the In-Sight system to the factory floor, connecting it to the lights, trigger source, power source. 
Control Pad, monitor, sensors, PLDs, and so on. 

1 1 . Test the system in the production enviroimient, optimizing it for accuracy and speed Goals include: 

o Validating the system's behavior over a wide range of normal and abnormal conditions, 
o Confirming that the worst-case execution time is less tfie longest allowable cycle, 
o Examining false accepts or rejects. Recording images associated with inaccurate results can 
help you diagnose and correct problems. 

12. If desired, lock the finished Job, preventing unauthorized changes. 

1 3 . Save the finished job, preserving the final parameter values. 

1 4. Archive the contents of flash memory to a PC. You can use the archive as a safety copy or for 
In-Sight-to-In-Sight job transfer. 

15. Run the production system. 



A ► Intro: Core Vision Processing Steps 

Vision applications differ in purpose and strategy but often have roughly the same underlying structure. This 
topic lists a representative sequence of steps for the vision processing part of an application. 

1 . Acquire an Image . A typical application snaps a new image in response to a trigger signal generated 
by a device that detects the presence of the item of interest. For other inputs, In-Sight also has ten 
discrete inputs — two in and two out on the Vision Processor, and eight in and eight out on the 
outboard I/O Expansion Module. 

2. Configure the System. Many applications require one-time or occasional operations such as building a 
model, establishing a calibrated tnuisformation, and so on. In-Sight lets you conditionally or 
unconditionally di.sable cells, freezing their contents. Configuration steps are good candidates for 
conditional updating. 

3 . Fixture the Part Manufacturing operations often do not perfectly constrain the location and orientation 
of the parts being inspected. Machine vision applications therefore must tolerate positional and angular 
uncotainty. A common strategy is to establish a fixture coordinate system in each image. Many 
applications identify the fixture origin and angle through pattern matching, edge detection, or another 
feature extraction technique. 

After finding the fixture origin — ^^ch might be a mark drawn on a part for this purpose, a distinctive 
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feature in the image, or a computed point— the application saves its row, column, and angle values. 
Subsequent operations refer to the fixture values to compensate for image-tp-image diffei^nces in 
location and orientation. Some applications find a new fixture coordinate system for each image; 
others iqxlate in only on failure. 

Define a Region of Interest (ROI). An ROI is an image area for image processing or feature 
extraction. An ROI is usually rectangular but sometimes angled, curved, circular, or toroidal. Its center 
is commonly the expected feature center. Its size depends on the feature size, positional uncertainty, 
angular uncertainty, and other factors. Keeping the ROI as small as practical reduces the number of 
pixels to process, reducing processing time. 

In-Sight supports several strategies for defining ROIs. An ROI can be: 
o Fixed. Its parameters are unchanging values. 

o Interactive. You can set its parameters with a graphic cursor drawn on the image and 

manipulated with the Control Pad 
o Calculated. The ROI values derive fiom worksheet formulas that adjust the ROI at run time, 
o Fixtured. The ROI is defined by offsets from a fixUire coordinate system. A special case of 

"calculated." 

5 ■ Process the ROI Pixels. LvSight offers a fiill con^liment of built-in image processing and image 

arithmetic algorithms. Finding the right combination of preprocessing steps can be a complex aspect of 
vision development. A high-pass filter, for example, strips out low-frequency infomiation— which 
might be "signal" in one context but "noise" in another. Appropriate image enhancement can greatly 
improve tfie application's reliability. 

6. Detect features. After enhancing the image, a typical application scans the ROI for the features) of 
interest In-Sight offers several feature extraction methods including edge detection, blob analysis, and 
histogram analysis, pattern matchint?. The choice of method depends on the characteristics of the 
feature in question. A linear feature, for exan^le, might suggest the use of edge-detection. 

For exan^le, if you are inspecting a part that should have three holes of the same size arranged in an 
equilateral triangle, then you expect the image to have three dark circles corresponding to the holes. 
Your apphcation might use edge detection to look for circular edges with the expected radius of 
curvature and light-to-dark transitions, 

7. Analyze features. After detecting features, the application usually evaluates them to derive useful 
information. A common goal is to validate the feature data against some expected profile. This feature 
analysis occurs in the worksheet, which offers mathematical and logical functions and operators, 
measurement functions, the ability to chart values over time, and other resources for data analysis. 

Continuing the example, after enhancing the image, the application could test the individual dots to 
confirm that they are the right size. Next, it could count them to confirm that exactly three are present, 
failing the inqjection if there are missing or extra dots. It could then measure all combinations of angles 
and distances to confirm the equilateral arrangement 

8 . Draw the results on the image. If the ^plication includes a monitor that displays the image, it might 
draw text or symbols on the image. 

9- Respond to the results. After examining the image features, most q^plications make a decision of 
some kind and take action if necessary. For inspection, the result is generally a pass-fail signal. For 
process control, it might be a numerical score passed to another device for evaluation and possible 
action. 

Continuing the example, if the feature analysis shows that the part has three holes in the right places. 
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then it passes the inspection and continues down the line. But if it fails a test, then it is a reject and 
removed from the line. In-Sight has ten discrete outputs; you might connect one to a device that 
removes defective parts from the production line. If necessary, you can delay the output in a buffer. If 
necessary, you can use calibration to map image locations to their real-world equivalents. 
1 0. Back to step one. 

Many real-world applications are elaborations on this flow of events. To consider these steps in a broader 
context, see Developinii end Deploying Applications , 


^ A ► Intro: Customer Support 

For options and accessories, call Cognex at 877-855-8705. For technical pioblems or questions, contact 
Cognex Technical Support through one of the methods listed below. 

Location Contact 
IJSA Cognex Corporation, Corporate Headquarters 

One Vision Drive / Natick, MA 01 760 
Main Tel: 508-650-6300; Fax: 508-650-332 1 
Email: tech_siq5port@cognex-com 

Hours: 8:30 am to 8:00 pm Eastern Standard Time, Monday through Friday 
MidatlanticCognex Corporation, Midatlantic Regional Technology Center 

530 East Swedesford, Suite 404 / Wayne, PA 19087 

Tel: 6 1 0-975-9592; Fax: 6 1 0-975-96 1 6 
Midwest Cognex Corporation, Midwest Regional Technology Center 

850 East Diehl Road, Suite 1 60 / Naperville, IL 60563 

Tel: 630-505-9990; Fax: 30-505-9995 
Southwest Cognex Corporation, Southwest Regional Technology Center 

1 00 Congress Avenue, Suite 2 1 00 / Austin, TX 7870 1 

Tel: 5 12-370-5245; Fax: 5 12-370-5247 
West CoastCognex Corporation, West Coast Regional Technology Center 

1001 Rengstorff Avenue / Mountain View, CA 94043 

Tel: 650-969-48 1 2; Fax: 650-969-48 1 8 
France Cognex France 

Immeuble le Patio / 104 avenue Albert ler/ 92563 Rueil Malmaison / France 

Tel: 011-33-1 -47-77-1 5-50; Fax: 0 1 1 -33- 1 -47-77- 15-55 

Email: europe_support@cognex.com 
Germany Cognex Germany 

Greschbachstrasse 12 / 76229 Karlsruhe / Gemiany 

Tel: 01 1-49-721-96187-0; Fax: 01 1-49-721-61566-1 
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Italy Cognex Italy 

Via Gasparotto, 1 

1- 20124 Milano - Mlltaly 

Tel: +39-02-6747 1200; Fax: +39-02-67471300 
Japan Cognex CKK 

2- 28-8 Honkomagome, Bunkyo-ku 
Tokyo 113-6591, Japan 

Tel: 011-81 -3-5977-5400; Fax: 01 1 -8 1 -3-5977-540 1 
Email: ckk_support@cognex.com 
Korea Cognex Korea, Inc. 

#805, DongKyung Building, 824-1 9 
YukSam-Dong, KangNam-Ku 
Seoul 135-080, Korea 

Phone: 01 1-82-2-539-9047 or 01 1-82-2-539-9048; Fax: +82-2-569-9823 
Singapore Cognex Singapore 

Block 51 Ayer Rajah Crescent 
#06-08/09 Ayer Rajah Industrial Estate 
Singapore 139948 

Tel: 01 1 -65-773-1 26 1 ; Fax 01 1 -65-773-1423 
UK Cognex UK 

Chancery House / 199 Silbury Boulevard / Milton Keynex, MK9 IJL 
United Kingdom 

Tel: 0 1 1 -44-1 908-206000; Fax: 0 1 1 -44- 1 908-392463 
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^ A ► Install: Overview 

This section describes how to install the In-Sight hardware and software. Please read the following topics 
before attenpting the installation: 

• Standard Components , • Testing the Installation 

• Optional Components • Testing the Lights 

• Preparing for Installation • Updating tlie Finnware 

• Installing the Hardware • Starting Up and Shuning Down 

• Installing the Software • Troubleshooting 

The general installation sequence involves connecting the Vision Processor with tiie Control Pad, camera, 
monitor, and power supply as well as otheis devices such as variable-intensity lights, an external trigger, 
strobe lights, and so on. When done, you should be ready to start developing your In-Sight applications. 

CAUTlOxN • Incorrect voltage creates a risk of fire or shock and can damage the In-Sight hardware. 

Never connect a power source other than 24v DC to the Vision Processor. When 
connecting the power source, carefully observe the correct polarity. 

• Avoid locations that expose the In-Sight hardware to excessive heat, dust, moisture, 
humidity, impact, vibration, corrosive substances, flammable substances, static 
electricity, or other environmental hazards. Any of these hazards can damage the 
In-Sight hardware. 

• ??To reduce the risk of damage or malfunction due to overvoltage, noise, power sur^ges, 
electrostatic discharge (ESD), or other imegularities: 

o Route all cables as far away as practical fix)m high- voltage power sources. 

o Connect an earth ground to the Vision Processor chassis. If you also ground the 

camera, then the Vision Processor chassis and camera chassis must have exactly 

same ground potential, 
o When handling electronic components, observe ESD precautions, such as the use 

of an anti-static wrist strap connected to a flat, grounded work surface. 

• Before connecting or disconnecting any equipment to the In-Si^t hardware, remove the 
power from In-Sigjit and from the equipment being connected or disconnected. 

• In-Si^ has a dedicated digital camera. Other cameras are incompatible. Connecting an 
off-tiie-shelf camera to the Vision Processor can damage the camera. Vision Processor, 
or both- 

• Do not open the In-Si^t Vision Processor, camera, or other hardware, which contain 
no user-serviceable internal parts. Do not make unauthorized electrical or mechanical 
modifications to the In-Sight hardware. 


^ A ► Install: Standard Components 
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The hardware components supplied with In-Sight depend on your configuration and options. Before you 
install In-Sight, ccHnpare the contents of the shipping container with those listed in packing slip. If anything is 
missing or damaged, call the shipping company. Also call Cognex as described in Customer Support . 


Component 
Vision Processor 
Control Pad 

Camera 
Camera cable 

Camera cable 
strain reliever 
Ferrite core 
Trigger 
Terminal Block 


Discrete I/O 
Terminal Block 


Power 

Terminal Block 


CD-ROM 
Getting Started 
With InSight 
Installing In-Sight 


Description 

System unit in cast aluminum housing. 
Pendant controller with four buttons plus a two-axis cursor. 
Integral 10-foot cable temiinated with a DB-15 connector. 
Dedicated digital camera. 

25-foot Category 5 shielded twisted pair (STP) cable 
temiinated with standard, 8-pin RJ-45 connectors. 
Flexible hood that protects the cables. 


Part Number 

800-5714-2 
800-5713-1 

118-0034 
XXX-YYY 

XXX-YYY 


Attached to Camera Cable, for European CE compliance. 
4-pin terminal block for cormecting trigger and strobe to the 
camera. 


XXX-YYY 
Cognex: 
XXX-YYY 
Phoenix : 
#1803594 

8-pin terminal block for connecting discrete I/O to the Vision Cognex: 


Processor. 


2-pin terminal block for connecting power to the Vision 
Processor 


Software and documentation. 
Hardcopy user guide. 


Hardcopy installation guide. 


XXX-YYY 

Phoenix : 

1803633 

Cognex: 

XXX-YYY 

Phoenix : 

1803578 

XXX-YYY 

XXX-YYY 

XXX-YYY 


^ A ► Install: Optional Components 


Component 
C-mount 
Lenses 


Extension 
tubes 


Description 

6.0 mm 
8.5 mm 
12.5 mm 
16.0 mm 
25.0 mm 
35.0 mm 
50.0 mm 

Set containing 0.5, 1.0, 5.0, 10,0, 20.0, and 40 mm extension 1 14-0009 
tubes. 


Part Number 
1 14-0049 
1 14-0039 
114-0004 
114-0018 
114-0001 
114-0041 
114-0040 
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Variable Lights 


Light Cable 
Light Cable 
Strobe 

Control Module 
Strobe cable 
Serial cable 

Serial adapter 
AC adapter 


I/O Expansion 
module 
I/O Module 
cable 


Back light 
Dai-k Field light 
Dome light 
Linear Array light 
On- Axis Diffiise liglit 
Ring light 
Spot light 

Y-adapter cable, 9-pin DIN to 7-pin DIN. 
Y-adapter cable, 9-pin DIN to RJ-1 1 
Interface box required for strobed operation. 


XXX-YYYY 
XXX-YYYY 
XXX-YYYY 
XXX-YYYY 
XXX-YYYY 
XXX-YYYY 
XXX-YYYY 
XXX-YYYY 
XXX-YYYY 
XXX-YYY 


Supplies power to Cognex strobes. XXX-YYYY 

?? 1 0-foot shielded Category 5 cable, terminated with XXX-YYY 
standard, 8-pin RJ-45 connectors. 

Converts the RJ-45 output to DB-9 fomiat XXX-YYY 

Converts 1 00v-240v AC line current (50-60 Hz) to 24v DC XXX-YYY 

current Three-foot leads on the DC side; removable AC 

power cord. ??different cords for different countries??. 

Connects up to 8 additional discrete inputs and outputs. 800-57 1 2- 1 


7-foot cable to connect the I/O module to the Vision 
Processor. 


300-0274-7 


^ A ► Install: Preparing for Installation 

To complete the installation, you must be familiar with your hardware and software enviionmait. Items that 
you might need include: 

• A 2 mm flat-head screwdriver, to tighten the screw on the terminal blocks. 

• Four '/4-inch bolts or other fasteners, to attach the Vision Processor to a convenient surface. 

• ?? ??-inch bolts or other fasteners, to attach the camera to a convenient surface. 

• A VGA-compatible monitor, to view images from In-Sight 

• A PC running Windows NT ?4.0? or higher, to run the In-Sight server software, used to archive jobs, 
archive images, issue commands by keyboard, and so on. 

• A PC running Internet Explorer 4.0 or higher, to view die online documentation, distributed as a 
compiled HtmlHelp (.chm) file. 

For information about obtaining lenses, lights, and other In-Sight options, contact Cognex. 
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^ A ► Install: Hardware 


This section details how to install each piece of hardware, discussing the following topics: 


• Attaching the Vision Processor 

• Connecting the Control Pad 

• Connectinti the Camera 

• Connecting an External Trigger 

• Connecting a Strobe Liglit 

• Connecting Vajiable-lntensitv Lights 


• Connecting a VGA Monitor 

• Connecting a Serial Device 

• Connecting Built-in Discrete I/O . 

• Connecting External Discrete I/Q . 

• Connecting a Power Supply 

• Troubleshooting 


Power (24 VDC) 
Power Indicator LED 
Reset switch 



Strobe output 


^ A ► Install: Vision Processor 


You can bolt the Vision Processor (P/N 800-57 14-2) to abnost any convenient surface using /4-inch or 
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smaller fasteners. General considerations in choosing a location include satisfying its environmental 
requirements and practical constraints such as cable routing. Due to its small size and geneiDus cable lengths, 
you enjoy great flexibility when locating and orienting the Vision Processor. 


U Horizontal orientation Vertical orientation 




Four 1/4-inch nnounting holes 

CALHION Avoid locations that expose the In-Sight hardware to excessive heat, dust, moisture, humidity, 
intact, vibration, corrosive substances, flammable substances, static electricity, or other 
environmental hazards. Any of these hazards can damage the In-Sight hardware. 

^ To Connect the Vision Processor 

1 . Choose a location: 

o Try to mount the Vision Processor in the open or in a well-ventilated cabinet. Do not impede its 
air circulation or block its cooling fins. Mounting the Vision Processor "iqjside down" reduces 
its cooling efficiency. 

o Prefer a horizontal or vertical orientation that provides easy access to the fix)nt panel and that 
minimizes tangling among the wires. One possibility is to attach it to a table with the connector 
edge in front; another is to attach it to a wall with the connector edge parallel to the floor. 

o The Vision Processor's base is uncoated stainless steel, so the electrical and thennal properties 
of the adjacent surface can affect the Vision Processor. Bolting it directly to a conductive, 
grounded surface is one way to provide an electrical ground A cool surface might provide a 
supplemental heat sink. 

2. Remove the 24v DC power from the hi-Sight system. To reduce the risk of malfunction or damage, 
never connect or disconnect hvSight components when power is present, 

3. Pass !/^-inch (or smaller) bolts through its mounting holes and into a solid surface. 

4. Connect an earth ground to the Vision Processor chassis. If you also ground the camera, then the 
Vision Processor and camera must have exactly same ground potential. 

NOTE The Vision Processor chassis is not intrinsically grounded. Its potential floats unless you 
supply a known ground. 

For more infonnation about the Vision Processor, see the In-Sidii Hardware Reference . 


^ A ► Install: Control Pad 

When you develop In-Sight applications, you connect a Control Pad (P/N 800-57 1 3- 1 ), which has an 
integral 1 0-foot cable. A deployed application that does not require operator input might retain or omit the 
Control Pad. 
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Control Pad 


► To Connect (he Control Pad 


CONTROL PAD port 
(DB-15 conr>ector) 


1 . Remove power from the Vision Processor. 

2. Plug the male DB- 1 5 connector at the end of the Control Pad cable into the Vision Processor's 
CONTROL PAD port. 

In-Sight automatically calibrators the attached Control Pad on power up. To calibrate it manually, 
simultaneously press the X, □, A, and O buttons. 

Most analog, 2-axis, 4-button PC game pads should work with In-Sight, which uses a standard DB-15 
game port pinout. If you lose or damage the In-Sight Control Pad, you can often reduce down time by 
substituting an off-the-shelf game pad. Cognex does not test In-Si^t with non-Cognex game pads, 
however, and cannot assure their compatibility. Special features such as "tuibo mode" are incompatible with 
In-Sight. You can order spare or replacement Control Pads from Cognex at 877-855-8705. 


^ A ► Install: Lens and Camera 

The In-Sight camera sends a video signal to the Vision Processor over a Category 5 shielded twisted pair 
(STP) cable terminated with standard RJ-45 connectors. The maximum cable length is 25 feet. Installation 
involves mounting the camera and connecting the cable to the camera and Vision Processor. This section 
describes how to install the camera and optics. 

C-mount 
lens 

Mounting 
block " 

4-pin 
Terminal 
Block 

Strobe output- 



" Trigger input 


CAMERA port 
(RJ-45 connector) 
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CAUTION • Avoid locations with excessive moisture, humidity, heat, dust, impact, and other hazards, 
which can damage the camera. 

• The camera chassis must have the same ground potential as the Vision Processor 
chassis. Any difference in pyotential creates a ground loop that can damage the camera. 
Vision Processor, or both. Using the non-conductive camera mounting block electricaUy 
isolates the camera from the mounting point, allowing the Vision Processor to supply a 
ground to the camera through^ le camera cable. In general, avoid attaching the camera 
directly to a conductive surface to avoid the risk of a ground loop. 

• The Vision Processor has three RJ-45 connectors, one for the camera and two for the 
serial ports. Make sure you plug each device into the correct connector. Plugging the 
camera into a serial port might damage the camera, the Vision Processor, or both. 

► To Mount the Camera 

1 . Choose a camera location based on the features of interest, optics, desired working distance, and so 
on. The mounting point should be as solid and stable as practical to avoid vibratioii, which can blur 
images. 

2. Screw a C-mount or CS-mount lens into the camera. Focal length depends on working distance, 
field-of-view, feature resolution, and other considerations. See Seiectins a Lens and the Fieid-of- 
P'iew Table , 

NOTE If using a CS-mount lens, add a 5 mm extension tube to compensate for the optical 

differences between C-mount and CS-mount systems. When calculating field-of-view, be 
sure to allow for the extension tube. 

3. If the camera is not attached to the non-conductive mounting block, attach the mounting block to the 
camera, (When shipped, the mounting block is attached, so this step is usually unnecessary.) 

4. Attach the mounting block and camera to a mounting post or other solid attachment point by means of 
the %-20 threaded attachment point on the bottom of the mounting block. 

5 . Remove power from the Vision Processor. 

6. ??To conform to European CE regulations, attach the feirite core to the camera cable. 

7. Plug one end of the camera cable into the camera's RJ-45 connector and the other end into the Vision 
Processor's CAMERA port. 

8. Connect wiring for a trigger input strobe output, or both through the detachable 4-pin terminal block. 

9. To prevent strain on the cormectors, fasten the camera cable at secure points near the camera and 
Vision Processor, allowing some slack between the fasteners and the connectors. 

For details about the camera and camera cable, see Camera Reference , 



^ A ► Install: External Trigger 

A trigger signal connects to the camera, not to the Vision Processor. You attach twisted pair or other 
suitable wiring through an intermediate, detachable terminal block, which bundles the wires together for easy 
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assembly and reassembly. Common trigger sources include photocells and proximity switches. Wiring size is 
22tol4AWG. 



RJ-45 connector 
(video out) 

Trigger + 
Trigger - 

Strobe + 
Strobe - 

► To Connect an External Trigger 

I . On the 4^sition temiinal block, insal the Trigger^ and Trigger- lines into the Trigger^ and Trigger- 
terminals: 


2. 
3. 
4. 
5. 
6. 



e>cD 


Trigger Strobe 

Trigger- Strobe- 

Tighten the set screws. 

If you are using a strobe, connect it to the terminal block as described in Connecting a Strobe Lieht . 
Remove power from the Vision Processor. 

Plug the terminal block, which is keyed to prevent incorrect insertion, into the camera. 

To prevent strain on the connector, fasten the trigger and strobe wires to a secure point near the 

camera, allowing some slack between the fastener and the terminal block. 


For details about the trigger signals, see Trie^er Signal Reference . 


^ A ► Install: Strobe Light 


The strobe signal fires an external strobe light It connects to the camera, not to the Vision Processor. You 
attach twisted pair or other suitable waring through an intennediate, detachable terminal block, which bundles 
the wires together for easy assembly and reassembly. Wiring size is 22 to 14 AWG. 
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( ^ A ► Install: Variable Lights 

I 

! The Vision Processor can control one or two Cognex-compatible variable-intensity lights. Not all 

I applications require dynamic light control, so variable-intensity hghts are optional. 


To sa^ 3 space on the front panel, the LIGHTS port cames the signals for both hghts on one 9-pin 
connector. Cognex hghts therefore include a Y-adapter cable that separates the signals for the two hghts. 
One leg of the Y terminates in a 9-pin DIN connector that plugs into the Vision Processor. The other legs 
temiinate in 7-pin DIN connectors that plug into the lights. 


Variable Light 0 



I 

integral tight cable 




Variable Light 1 Y-Adapter Cable LIGHTS port (RJ-45) 
► To Connect Variable-Intensity Lights 

NOTE The connector that carries the light control signals can also supply power to certain Cognex strobe 
lights. To use a variable-intensity hght and a strobe at the same time, you must supply external 
power to the strobe. 

1 . Obtain one or two variable-intensity hidits. each siq>plied with a Y-adapter cable (P/N XXX- YYY). 

2 . Remove power from the Vision Processor. 

3. Plug the Y-adapter cable's 9-pin mini-DIN connector into the Vision Processor's LIGHTS port. 

4. For the first light, plug one of the Y-adapter's 7-pin DIN connectors into die matching connector on 
the end of the light's integral cable. 

5 . If you are using two lights, plug the other hght connector into the second light. 

6. To prevent strain on the connectors, fasten the cables at secure points near the Vision Processor and 
lights, allowing some slack betwe^ the fasten«s and connectors. 

For details about variable-intensity lights, see Avail able Lwhts . For hardware details about the hght port, 
see Lisht Control Port . For software details, see Controlling Variable Lifrhts . 


^ A ► Install: VGA Monitor 
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RJ-45 connector 
(video cut) 

Trigger + 
Trigger - 

Strobe + 
Strobe - 

► To Connect Strobe Light 

1 . On the 4-position temiinal block, insert the St^obe^- and Strobe- lines into the Strobe+ and Strobe- 
taminals. 



e><D 


n ■ ^ 


4 


Trigger Strobe + ^ 

Trigger- Strobe - 

2. Tighten the set screws. 

3, Remove the power from the Vision Processor. 
??If you are using a Cognex strobe that obtains power from the Vision Processor, plug the 9-pin end 
of the supplied cable into the matching connector on the fix)nt panel of the Vision Processor. 

NO TES • The same connector carries the light control signals for variable-intensity lights. To 
use an variable-intensity light and a strobe at the same time, you must supply external 
power to the strobe. 

• ??You must set the light power parameter to 255 to enable power to the strobe. For 
details, see Acquirelmage . 

5. If you are using an external trigger, connect the trigg^ wires to the temiinal block as described in 
Connecting^ an External Tri^^er . 

6. Plug the terminal block into the camera. 
To prevent strain on the connector, fasten the trigger and strobe wires to a secure point near the 
camera, allowing some slack between the fast^er and the temiinal block. 


7 


For details about the strobe signals, see Strobe Shjnal Reference^ 
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Inputs 


Returns 
Emits 
Errors 
Comments 

See Also 


Circle 
— Row 
— Column 
— Radius 
Name 
Color 
Show 
Plot 
Nothing. 
Invalid parameter. 

One way to define the circle graphic in a fixtured coordinate system instead of the image 
coordinate system is to obtain the circle parameters from a Circle structure. 
PlotArc. PlotCross. PlotLine. PlotPoint. PlotRegion. PlotString. Gettins Started with 
Jnia^e Graphics . 


A circle, defined by the row and column coordinates for the center point (in 
pixels fix)m the image origin) and a radius (in pixels). 


A label for the circle. A string or a reference to one. 
A color, selected from a list. 
ON to enable the circle graphic; OFF to disable it. 
On success, a Plot stmcture . which stores the graphic. 


^ A ► Graphics: PlotCross function 


Description 
Heading 
Syntax 
hiputs 


Returns 
Emits 
Enors 
Comments 

See Also 


Draws a cross mark graphic with a specified center, angle, height, width, label, and color. 
Graphics/Image 

PlotCross(Cross, Name, Color, Show) 

Cross A cross maik, defined by its center point (row and column, in pbcels from 

— Row the image origin), its angle (a rotation, ± 360° CCW from the image row 
— Column axis), and its height and width (in pixels). 
— Angle 
—High 
—Wide 
Name 
Color 
Show 
Plot 
Nothing. 
Invalid parameter. 

One way to define the cross mark graphic in a fixtured coordinate system instead of the 
image coordinate system is to obtain the cross parameters from a Cross structure. 
PlotArc. PiotCircle. PlotLine , PlotPoint PlotRegion. PlotString. Getting Started Plotting^ 
Graphics . 


A text label for the cross maik. A string or a reference to one. 

A color, selected from a list 

ON to enable the cross mark; OFF to disable it. 

On success, a Plot structure, which stores the graphic. 


A ► Graphics: PlotLine function 
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Description 
Heading 
Syntax 
Inputs 


Returns 
Emits 
En-ors 
Comments 

See Also 


Draws a line graphic between two points. 
Graphics/Image 

PIotLine(Line, Name, Color, Show) 

line A line, defined by its end points, in pixels from the image origin. 

— Row 0 
— Column 0 
— Rowl 
— Column 1 
Name 
Color 
Show 
Plot 
Nothing. 
Invalid parameter. 

One way to define the line graphic in a fixtured coordinate system instead of the image 
coordinate system is to obtain the line parameters from a Line structure. 
PlotArc. PlotCircIe. PlotCross, PlotPoinL PlotRegion. PlotString. Getting Storied 
Plotting Graphics . 


A text label for the line graphic. A string or a reference to one. 

A color, selected from a list. 

ON to enable the line graphic; OFF to disable it. 

On success, a Plot structure, which stores the graphic. 


^ A ► Graphics: PlotPoint function 


Description Draws a point graphic at a specified point in the image. 
Heading Graphics/lmage 
Syntax PlotPoint(Point, Name, Color, Show) 

Inputs Point A point, defined by its row and column coordinates, in pixels from the 

— Row image origia 

— Column 

Name 

Color 

Show 
Returns Plot 
Emits Nothing. 
Errors Invalid parameter. 

Comments One way to define the point graphic in a fixtured coordinate system instead of the image 
coordinate system is to obtain the row and column parameters from a Point structure. 

See Also PlotAixr . PlotCircIe. PlotCross. PlotLine. PlotRegion. PlotStrintz. Gg///>?g Started 

Plotting Graphics . 


A label for the point. A string or a reference to one. 
A color, selected from a list. 
ON to enable the point graphic; OFF to disable it. 
On success, a Plot strucuire. which stores the graphic. 
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A ► Graphics: PlotRegion function 


Description 
Heading 
Syntax 
Inputs 


Returns 
Emits 
Errors 
Comments 

See Also 


E>raws a rectangular region graphic, potentially rotated and curved. 
Graphics/Image 

PlotRegion(Region, Name, Color, Show) 


Region 
— Row 
— Column 
— ^Angle 
—High 
—Wide 
— Curve 
Name 
Color 
Show 
Plot 

Nothing. 
Invalid parameter. 

One way to define the region graphic in a fixtured coordinate system instead of the image 
coordinate system is to obtain the region parameters from a Region structure. 
PlotArc . PlotCircle. PlotCross. PlotLine. PlotPoint PlotStrintz. Gettine Starred Plotting 
Graphics . 


A rectangular region, defined by its top-lefi point (row and column, in 
pixels from the image origin), its angle (a rotation, ± 360"* CCW from the 
image row axis), its height and width (in pixels), and its curvature (the angle 
between the sides of the region, ± 360** CCW). For curved regions, 
"width" is the arc distance at the center of the region. 


A text label for the region graphic. A string or a reference to one. 

A color, selected from a list. 

ON to enable the region graphic; OFF to disable it. 

On success, a Plot structure, which stores the graphic. 


^ A ► Graphics: PlotString function 


Description 
Heading 
Syntax 
Inputs 


Returns 
Emits 
Errors 
Comments 
See Also 


Draws a string graphic at a specified point, in a specified color. 
GnqDhics/Image 

PlotString(String, Point, Color, Show) 
String A string or a reference to one. 

Point The location of the string, defined by its top-lefl point, in pixels fix)m the 

— Row image origirL 
— Column 
Color 
Show 
Plot 
Nothing. 
Invalid parameter. 
None. 

PlotArc. PlotCircle. PlotCross. PlotLine, PlotPoint, PlotRegion. Gettine Started Plotting 
Graphics , 


A color, selected from a list. 

ON to enable the string graphic; OFF to disable it. 

On success, a Plot structure, which stores the graphic. 
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A ► Graphics: Status function 


Description 
Heading 
Syntax 
Inputs 


Returns 

Emits 

Exanple 


Errors 
Comments 
See Also 


Puts a status display in a cell. Green if positive; yellow if 0.00; red if negative. 
GraphicsAVorksheet 

Status(Status, GreenString, YellowString, RedString) 

The cell monitored for its status. Green if Status is positive; yellow if 
0.0; red if negative or an error. 

A label for the status graphic when Status is positive. A string or a 
reference to one. 

A label for the status graphic when Status is zero. A string or a 
reference to one. 

A label for the status graphic when Status is negative or error. A string 


Status 

GreenString 
YellowString 
RedString 


0,0 on success. 
Nothing. 

or a reference to one. 



\ \ \ 




|5(H=^Arfi;|Mi>fl 



Status parameter^ by reference 
String parameter, by reference 


Invalid parameter. 
None. 

Chart, ColorLabeL Getting Started with Worksheet Graphics , 
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A ► Hist: Overview 

Histogram analysis is a technique for finding the distribution of grayscale values in an image. Preparing a 
histogram involves countin the number of occurrences of each grayscale value, placing each total in a "biiL" 
An 8-bit image has 256 grayscale values, from 0 (black) to 255 (white), so its histogram has 256 bins. The 
bin number equals the grayscale value totaled there. Bin 0, for instance, ho!ds the count of pixels at grayscale 
0; bin 1 holds the count at grayscale 1 ; and so on. 

Common uses for histogram analysis are feature extraction and image analysis. For example, siq^pose your 
application inspects industrial parts that normally yield histograms with a peak near grayscale 64 (the part) 
and another near grayscale 200 (the background). Also suppose that you occasionally acquire blank images, 
with all values near grayscale 2(X). Testing for images that lack the peak near grayscale 64 would let you 
exclude the blank images from further processing. Here, the histogram acts like a light meter. 

This section introduces In-Sight's Histogram functions, discussing the following topics: 

• Getting Started with Histograans 

• Understanding Histograms 

• Histogram Statistics 

• Histogram Reference . 

With In-Sight, you generate a histogram with the ExtractHistoeram fimction (under Vision Processint?\ which 
stores the histogram and its statistical profile in a Hist strucuire . Values emitted to the worksheet include an 
automatically computed binary threshold (the grayscale value that best separates the image into light and 
daik regions) and the averages for the light region, dark region, and entire histogram. Statistics available for 
all or part of the histogram include the number of pixels, the first and last non-zero gray level (head and tail), 
the most and least common gray levels (maximum and minimum), the sum, and the standard deviation. 


^ A ► Hist: Getting Started 

This topic describes basic steps for extracting a histogram from an image. The result looks Uke this: 


Maximum value 
Theshold value 



^ — Region of interest 
Threshold 

Histogram 
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Minimum value 



^ To Extract a Histogram 

1 - Acquire an appropriate image. For this exercise: 

a. Open the part sample iiTiage. print it, and return to this topic. Place the printed image under tiie 
camera. 

b. Click A, select Live from the System menu, and click X to enter live mode. Interactively 
adjust the image location, camera height, aperture, and focus until satisfied with the image. 

c. Click A twice to exit live mode, acquire the last image, and return to the worksheet 

To acquire a new image at any time, hold □ and click X. 

2. Leaving ceil Al empty, move to ceU A2 and click Xto open the Formula Builder. From the Vision 
Processing category, select Histogram, and click X to open the ExtractHistogram property sheet. 
NOTE Try to leave a blank row above functions that emit formulas. hi-Sight prints descriptive labels 

above emitted formulas if it has room for the labels. If the row above is occupied, it emit*; 
only the numeric values, without labels. 

3 . To define a region of interest, select the Region head and click X. In-Sight hides the property sheet 
and displays the Region cursor, which you interactively adjust with the Control Pad. Outline an area 
that contains a feature showing a range of grayscale values. 

4. When satisfied with the region, click X to accept it, and then click Run. ExtractHistogramQ computes 
a histogram for the specified region and displays it at the bottom of the property sheet. To view only 
the histogram and image, click A to toggle the property sheet overlay ON or OFF: 


Maximum value 
Theshold value 

Minimum value 



5. Click OK ExtractHistogramQ recomputes the histogram, stores it in a Hist stnicuire, and emits a 
block formulas that put statistical results on the worksheet: 



Thresh 

Contrast \ 

A>preDark 

AveBright 

Average 





> 1201708"! 



See Histosra/n Statistics for details about the emitted values. 


6. To use an emitted value in a formula, create a reference to its cell. To simplify the worksheet, consider 
deleting unneeded emitted formula. 
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By defeuJt, Ir>-Sight displays the histogram graphic only when you highlight the Hist structure, as described in 
Flyover Graphics. To di^lay the histogram graphic all the time, set the ExtractHistogramQ fiinction's Show 
parameter to Show AU. 



A ► Hist: Understanding 

A histogram is an array of integers that represent the distribution of the pixel values in a region of interest. 
Each element in the array, called a bin, holds a count of the number of pixels at a particular grayscale value. 
The bin indexes correspond to the grayscale values counted there. That is, bin 0 holds the number of pixels 
at grayscale 0, bin 1 holds the number of pixels at grayscale 1, and so on. The total of all bin counts always 
equals the number of pixels in the region. 

A typical histogram has peaks ^ or modes^ corresponding to the pixel values in the dominant features in the 
image. For example, consider a binary image and its histogram: 

Image Histogram 



3 


Feature Background 

Here, only two bins have non-zero contents: the pixel value of the feature and the pixel value of the 
background. 

Real images seldom have histograms like this. Noise fiom various sources — irregular lighting, uneven 
printing, electrical noise, spatial quantization error, and so on — combine to spread out the peaks. A more 
realistic histogram of the scene as viewed through a camera might look like this: 



Left Feature Right 

tail edges tail 

Pixel values 

This histogram cleariy shows both peaks, which have spread out to include neighboring pixel values. Their 
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relative proportions nonetheless remain about the same as those in the "ideal" (binary) histogram. The less- 
populated pixel values between the two principal peaks are the edges of the feature, which are neither 
whoUy dark nor wholly light The left and right tails contain outlying points, having values that might be 
unreliable due to noise. To limit the effect of noise, your application might ignore the tails as unreliable eixi 
points- 


The ExD^ctHistogram function computes a histogram and stores it in a Hist staicturc . It also stores a set of 
statistical values describing the histogram. Some of the statistical values are emitted to the worksheet but 
most are not. The emitted values are: 

• Thresh. Binary threshold, which is the grayscale value that best separates the histogram into dark and 
bright regions — the optimum bimodal distributioa Emitted by HistTliresh . 

• Contrast. Grayscale contrast, which is the difference between the average bright value and the 
average dark value (that is, AveBright minus AveDark). Emitted by HistContrast . 

• AveDark. The average grayscale value in the dark region (the values below the threshold). 
Computed by HistMean over the range of 0 through Thresh — 1 . 

• AveBright, The average grayscale value in the bright region (the values above the threshold). 
Computed by HistMean over the range of Thresh through 255, 

• Average. Arithmetic average over the histogram as a whole, from bin 0 to bin 255. Emitted by 
HistMean . 

Additional values, stored but not emitted, that can be read through Data Acess functions are: 

• Count. Number of pixels. Available fiiom HistCount . 

• Head. First non-zero gray level. Available from HistHead . 

• Tail, Last non-zero gray level. Available from HistTail 

• Maximum. Most-common (modal) gray level. Available from HistMax . 

• Mimmum. Least-common gray level. Available from HistMin . 

• SDe V. Standard deviation. Available fix)m HistSDev . 

• Sum. Sum of the grayscale values. Available from HistSum . 

• SumSquare. Sum of the squares of the grayscale values. Available from HistSiunSqitare . 

• Vahie. Number of values in a bin or range of bins. Available from GetVaiue . 

You can read any of these values over the histogram as a whole (the default) or limited to a specified 
grayscale range. 


CC3GIMEX 



A ► Hist: Statistics 


CXSGIMEX 



Appendix I - Page 21 0 


MSDOCIft <WO__0111445A2_I_> 


wo 0 1/1 1 445 PCT/USOO/22383 


M A ^ Hist: Function Reference 

ExtractHistogram Computes a grayscale histogram from an image region, storing it in a Hist structure. Emits 
histogram statistics. 

Hist structure Stores a histogram and histogram statistics. Generated by ExtractHistogramQ. 
HistContrast . Returns the grayscale contrast value (the average bright value minus the average dark 

value) for all or part of the histogram. 
HistCount Returns the number of pixels, by default for the entire histogram. 

HistHead Returns the index of the first non-zero gray level for all or part of the histogram. 

HistMax Returns the most-common (modal) gray value for all or part of the histogram. 

HistMeaji Returns the average grayscale value for all or part of the histogram. 

HistMin Returns the least-common grayscale value for all or part of the histogram. 

HistSDev Returns the standard deviation value for all or part of the histogram. 

HistSiun Returns the sum of the grayscale values for all or part of the histogram. 

HistSum Square Returns the sum-of-squares value for all or part of the histogram, 
HistTail Returns the index of the last non-zero gray level for all or part of the histogram. 

HistThresh Returns the optimum binary threshold value (the grayscale value that best separates the 

histogram into daric and bright regions). 

A Data Access function that get value from a Hist structure is GctValue . 


A ► Hist: ExtractHistogram function 


Description 

Heading 

Syntax 

Inputs 


Computes a grayscale histogram from an image region, storing it in a Hist structure. Emits 

histogram statistics. 

Vision Processing/Histogram 

ExtractHistogram(lmage, Fixture, Region, Show) 


Image 
Fixture 
— Row 
— Column 
— Theta 

Region 

—X 

— Y 

—High 

—Wide 

— Angle 

Show 


Image data source, a reference to an Lnage structure . Default is $A$0. 
Fixture origin, defined by row, column, and angle offsets, typicaUy to 
compensate for image-to-image variation in position, orientation, or both. 
Row and Column are offeets, in pixels from the image origin. Theta is a 
rotation fir>m the image row axis, ± 360** CCW. Defaults all 0 (the image 
origin). See Workine with Fixtures . 

Region of interest. X and Y define the tc^Iefl point by offsets from the 
Fixture origin, in pixels. High and Wde are the height and width, in pixels. 
Angle is a rotation finom the Fixture X axis, ± 360° CCW. See Definino a 
Region of Interest . 


Selects the graphics to display, as described in Flvover Graphics : 
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• HideaU 

• Result graphics only 

• Input and result graphics 

• Show all, which displays input, result, and chart (if any) graphics. 


Stores Hist On success, a Hist structure, vMch stores the histogram. 

Emits Thresh The gray level that best separates the histogram into dark and bright 

regions — the optimum bimodal distribution. Emitted by HistTliresh . 
Contrast The difference between the average bright value arKi the average dark 

value (AveBright minus AveDark). Emitted by HistContrast , 
AveDark The average grayscale value in the dark region (values below the 

threshold). Computed by HistMean from 0 to Thresh - 1 . 
AveBright The average grayscale value in the dark region (values above the 

threshold). Computed by HistMean fix>m Thresh to 255. 
Average The average value of the histogram as a whole, from bin 0 to bin 255. 
Emitted by HistMean . 
Errors Invalid parameter. 

Comments None. 

See Also HistContrast , HistCount, HistHead . HistMax, HistMig HistSum, HistSiunSquare. 

HistTail HistThresh, GetValue, Geitin^i Started w^ifh Histosrrams 


^ A ► Hist: Hist structure 


Access function 

HistContrast 


Description Stores a histogram and histogram statistics. Generated by ExtractHistogramQ. 
Values Value Descnption 

Contrast Grayscale contrast. Equal to the average bright 
value (>= Thresh) minus the average dark value 
(< Thresh). Emitted for the entire histogram, bin 0 
to bin 255, but optionally limited to a range of bins. 
Count Number of pixels in a bin or range of bins. Not HistCount 

emitted. Defaults to the entire histogram, bin 0 
through bin 255. 

Head First non-zero gray level. Not emitted. Defaults to HistHcad 

the entire histogram but optionally limited to a range 
of bins. 

Maximum Most-common gray level (the statistical mode). Not Hist Max 
emitted. Defaults to the entire histogram but 
optionally limited to a range of bins. 

Mean The arithmetical average of the histogram, optionally HistMean 

limited to a range of bins. Separately emitted for the 
bright region, dark region, and entire histogram. 

Minimum Least-common gray level. Not emitted. Defaults to HistMin 
the entire histogram but optionally limited to a range 
of bins. 
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Comments 


See Also 


SDev Standard deviation. Not emitted. Defaults to the HistSDev 

entire histogram but optionally limited to a range of 
bins. 

Sum Sum of the grayscale values in a bin or range of HistSiun 

bins. Not emitted. ??Defaults to the entire 
histogram?? 

SumSquare Sum of the squares of the grayscale values. Not HistSumSquare 

square-rooted, since you can separately calculate 

the square root of the sunvsquare value if desired. 

Not emitted. Defaults to the entire histogram but 

optionally limited to a range of bins. 
Taa Last non-zero gray level. Not emitted. Defaults to HistTail 

the entire histogram but optionally limited to a range 

of bins. 

Threshold The gray level that best binarizes the image. Emitted HistThresh 

for the entire histogram, bin 0 to bin 255, but 

opticMially limited to a range of bins. 
Value Number of values in a specified bin. ??Which bin is GetValue 

the default?? Not emitted. 
For most histogram statistics, you can obtain values for the entire histogram (the default) 
or limited to a specified grayscale range (by supplying the access function's range start and 
range end parameters). 
ExtractHistogram . 


A ► Hist: HistContrast function 


Description 

Heading 

Syntax 

Inputs 


Returns 
Emits 
Errors 
Comments 
See Also 


Returns the grayscale contrasit value (the average bright value minus the average dark 
value) for all or part of the histogram 
Vision Processing/Histogram 
HistContrast(Hist, [Range Start, Range End]) 

Hist A reference to a Hist structure, generated by ExtractHistogram . 

Range A range of bins, defined by starting and ending grey levels (0 through 255, 

— Start inclusive). Start defaults to 0, and End defaults to 255 (the entire 

— End histogram). 

Grayscale contrast, a floating-point value. 

Nothing. 

Invalid parameter. 
None. 

Hist smicture. HistCoiuU . Hi.stHead. HistiVfax. HistSDev^ HistTail . 
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^ A ► Hist: HistCount function 


Description 
Heading 
Syntax 
Inputs 


Returns 
Emits 
Enors 
Comments 
See Also 


Returns the number of pixels in a range of bins. 
Vision Processing/Histogram 
HistCount(Hist, [FirstBin, LastBin]) 
Hist A reference to a Hist stn'cture. 

Range A range of bins, defined by st jrting and ending grey levels (0 through 255, 

Start inclusive). Start defaults to 0, and End defaults to 255 (the entire 

— End histogram). 

The number of pixels in a range of gray levels. 

Nothing. 

Invalid parameter. 
None. 

ExtractHistogram . 


A ► Hist: HistHead function 


Description 
Heading 
Syntax 
Ii^uts 


Returns 
Emits 
Errors 
Comments 

See Also 


Returns the index of the first non-zero gray level, by default for the entire histogram. 
Vision Processing/Histogram 
HistHead{Hist, [Range Start, Range End]) 

Hist A reference to a Hist stnicturc. generated by ExtractHistogram. 

Range A range of bins, defined by starting and ending gray levels (0 through 255, 

Start inclusive). Start defaults to 0, and End defaults to 255 (the entire 

— End histogram). 

Index of the first non-zero gray level. Vahd range, 0 through 255. 
Nothing. 

Invalid parameter. 

Specifying a range lets you separately obtain the local "heads" from histograms with more 
than one peak. 

Hist structure, HistContrast. HistCount HistMax, HistSDev, HistTail. 


^ A ► Hist: HistMax function 
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Description 
Heading 
Syntax 
Inputs 


Returns 

Emits 
Errors 
Comments 
See Also 


Returns the most-common (modal) gray value, by default for the entire histogram. 

Vision Processing/Histogram 

HistMax(Hist, [FirstBin, LastBin]) 

Hist A reference to a Hist structure. 

Range A range of bins, defined by starting and ending grey levels (0 through 255, 

— Start inclusive). Start defaults to 0, and End defaults to 255 (the entire 
— End histogram). 

The most common (modal) gray level within a range. 
Nothing. 

Invalid parameter. 
None. 

ExtractHistogram. HistMin . 


^ A ► Hist: GetMean function 


Description Returns the average grayscale value, by default for the entire histogram. 

Heading Vision Processing/Histogram 

Syntax GetMean(Hist, [FirstBin, LastBin]) 

Inputs Hist A reference to a Hist structure, generated by ExtractHistogramQ. 

Range A range of bins, defined by starting and ending grey levels (0 through 255, 

— Start inclusive). Start defaults to 0, and End defaults to 255 (the entire 
— End histogram). 
Returns The mean value of the buffer- 

Emits Nothing. 
Errors Invalid parameter. 

Comments None. 

See Also ExtractHistogram. Hist strucaire . 


^ A ► Hist: HistMin function 


Etescription Returns the least-common grayscale value, by default for the entire histogiam. 
Heading Vision Processing/Histogram 

Syntax HistMin(Hist, [FirstBin, LastBin]) 
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Inputs 


Returns 
Emits 
Errors 
Comments 
See Also 


Hist A reference to a ExtractHistogram structure. 

Range A range of bins, defined by starting and ending grey levels (0 through 255, 

— Start inclusive). Start defaults to 0, and End defaults to 255 (the entire 

— End histogram). 

The least-<:ommon value in the range. 

Nothing. 

Invalid parameter. 

None. 

HistMax. 


^ ▲ ► Hist: HistSDev function 


Description 
Heading 
Syntax 
Inputs 


Returns 
Emits 
Errors 
Comments 
See Also 


Returns the standard deviation value, by default for the entire histogram. 
Vision Processing/Histogram 
HistSDev(Hist, [FirstBin, LastBin]) 

Hist A reference to a Hist structure, generated by ExtractHistogramO- 

Range A range of bins, defined by starting and ending grey levels (0 through 255, 

— Start inclusive). Start defaults to 0, and End defaults to 255 (the entire 
— Fjid histogram). 

Standard deviation, a standard statistical measure. 
Nothing. 

Invalid parameter. 
None. 

Extractl-Iistogram, Hist structure . 


^ A ► Hist: HistSum function 


Description 
Heading 
Syntax 
Inputs 


Returns 


Returns the sum of the grayscale values, by default for the entire histogram. 

Vision Processing/Histogram 

HistSum(Hist, [FirstBin, LastBin]) 

Hist A reference to a Hist structure. 

Range A range of bins, defined by starting and ending grey levels (0 through 255, 

— Start inclusive). Start defaults to 0, and End defaults to 255 (the entire 

— End histogram). 

The total number of pixels in the range. 


Emits 
Enors 
Comments 


Nothing. 

Invalid parameter. 
None. 
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See Also ExtractHistogtBm . 



^ A ► Hist: HistSumSquare function 


Description 
Heading 
Syntax 
Inputs 


Returns 
Emits 
Errors 
Comments 
See Also 


Returns the sum-square value for all or part of the histogram. 
Vision Processing/Histogram 
HistSumSquare(Hist, [Range Start, Range End]) 

Hist A reference to Hist structure, generated by ExtractHistogram . 

Range A range of bins, defined by starting and ending grey levels (0 through 255, 

—Start inclusive). Start defaults to 0, and End defaults to 255 (the entire 

— End histogram). 

Sum-square value. 

Nothing. 

Invalid parameter. 

The result is the simple sum of the squares, not the square root of the sum of the squares. 
Hist structure. HistContrast. HistCount HistHead. HistMax. HistSDev. HistTail. 


^ A ► Hist: HistTail function 


Description 
Heading 
Syntax 
Inputs 


Returns 
Emits 
Errors 
Comments 

See Also 


Returns the index of the last non-zero gray level, by default for the entire histogram. 
Vision Processing/Histogram 
HistTaiI(Hist, [Range Start, Range End]) 
Hist A reference to a Hist structure. 

Range A range of bins, defined by starting and ending grey levels (0 through 255, 

— Start inclusive). Start defaults to 0, and End defaults to 255 (the entire 
— End histogram). 

The index of the last non-zero gray level. Valid range, 0 through 255. 
Nothing. 

Livalid parameter. 

Specifying a range lets you sq>arateiy obtain the local "tails" from histograms with more 
than one peak. 

Hist stgjcture. HistContrast. HistCount. HistHead. HistMax. HistSDev . 
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Description 

Heading 

Syntax 

Inputs 


Returns 
Emits 
Errors 
Comments 
See Also 


Returns the optimum binary threshoJd value (the grayscale value that best separates the 
histogram into dark and bright regions). 
Vision Processing/Histogram 
HistThresh(Hist, [FirstBin, LastBin]) 

Hist A reference to a Hist structure, generated by ExtractHistogram . 

Range A range of bins, defined by starting and ending grey levels (0 through 255, 

— Start inclusive). Start defaults to 0, and End defaults to 255 (the entire 

— End histogram). 

Threshold. 

Nothing. 

Invalid parameter. 
None. 

Hist structure, HistContrast. HistCount. HistHead HistMax. HistSDev. HistTaiL 
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^ A ► Image Processing: Overview 

The Image Processing heading, under Vision Processing, offers functions that change the values of the pixels 

in an image, yielding a modified image as a result. Its subheadings are: 

Image Performs pixel-processing or image enhancement operations: 

Processing 

• Neighborhood filters operations consider the values of the surrounding pixels when 
changing a pixel value 

• Point filters ignore the surrounding pixels. 


Many In-Sight applications use image processing to enhance an image before applying 
feature extraction to obtain information about its content. 

Compares an image with a template to detect their differences. A common use is detecting 
anomalies in inspection applications. 

A polar transformation that unwraps a curved or circular feature into a second, rectangular 
image. rfransWarpToPLxeK under Coordinate Transforms, maps a point in the warped 
image back to the original image.) 

This section describes image comparison, image processing, and image warping; 

• Gettin Started with Image Comparison • Understanding Image Processing 

• Understanding Image Comparison • Getting Started with Liiage Warning 

• Getting Started with Image Processing • Image Processing Reference . 


Image 

Comparison 

Image 

Warping 



^ A ► Image Comparision: Getting Started 

You typically use normalized Template Subtraction to determine presence/absence, find defects, and locate 
identifying maikCTs. in this section, you use template comparison to compare an image with a template to 
measure the degree of disagreement. 

^ To Compare an Image 

1 . Gather Training Images. Provide the tool a nimiber of training images. You do this by setting up the 
ROI, fixtured, and setting the AddTrainlmage flag to 1. Every time the job runs, a new image is 
added. 

2. Set the AddTrainlmage flag to 0. 

3. Set Up Training. Select the normalization method: graylevel scaling, histogram fitting, mean/std dev 
fitting or image fitting. None can also be used 

4. Decide whether to remove extreme gray values fiom the calculation. The tails of the image graylevel 
distribution are sometimes the result of noise and can be unreliable. Set the Tail Clipping flag to tme 
and the amounts to clip off either end of the distribution in the Left Tail and Right Tail variables. 
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5. Set the Edge Tolerance. This adjusts training for small differences in registration that may not show 
up in the training set 

6. Train the tool. Set the Train flag to 1 . 

7. Exit the tool. This trains, creating an ideal image of averages, and collects pixel by pixel statistics - 
the standard deviation of the training set 

8. Set up for execution. Set the Train flag to 0. 

9. Set the Tolerance Percent. This is the range of variation expected 2 is the best — 2 standard 
deviations. 

1 0. Set the noise tolerance, to allow for noise in regions of litde variation in the training images. 

11. Set up ix)st processing. The tool generates a black and white image, where differences show up as 
white blobs. Use the blob tool to detect them. 


^ A ► Image Comparison: Understanding 

Some machine vision applications look for differences between an ideal part and a test part. Changes stand 
out when the image of the ideal part is subtracted from the image of the test part. Applications that can 
benefit finom image comparison include: 

• Defect detection 

• Sorting similar 

• Searching for identifying markers. 

In addition, the perfonmance of many vision tools can be enhanced by subtracting known backgrounds from 
an image. 

Here are some key concepts in image comparison: 

1 . The definition of image comparison 

2. Image sizes 

3 . Values of result pixels 

4. The nomiali2ation of gray levels in images. 

Image Comparison 

When the comparison tool compares one image (called the template image) to another image (the input 
imageX it subtracts the value of each pixel in the ten:q>late image from the corresponding pixel in the input 
image. It then conpares die result to the tolerance value for that pixel, stored in a third image (the sigma or 
standard deviation image), and stores the result in a fourth image, the ou^ut image. The result image pixels 
are white where the subtraction results are outside the tolerance value, and black where they are within the 
tolerance. The output image can be used as input to subsequent tools, such as the blob tool or search tool, 
or it can be processed further using the process tool. 

Image Sizes 
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If the template image and the input region in the input image differ in size, the compare tool cannot make a 
meaningful comparison, as it would have to align the images and region in some manner. The size of the 
template image is set when the compare tool is trained, as the size of that input region. The input region 
height and width should not be altered unless you want to retrain the template image and sigma image. 

If you define the Compare too! input region with respect to a fixture that rotates each time the spreadsheet 
tool nms, that region also will be ratated. Although the region rotates, the input image will be the same size as 
the template image, and the compare filter will execute. If you define the Compare tool input region by 
referencing a height and width which is calculated elsewhere in the spreadsheet, the Compare tool will retrain 
every time the input region height or width changes- 
Pixel Values 

The Comparison too! uses one method for determining output. It checks both positive and negative 
differences differences between the template and input images, and returns white pixels where the differences 
are beyond the tolerated range in either the positive or negative direction. Because it captures both negative 
and positive changes, it does not allow you to distinguish between lighter and darker areas. The pixel values 
in the returned image are either 0 (black) or 255 (white). 

Image Normalization 

The process of image subtraction is sensitive to changes in lighting, jitter, and noise. Even a small variation in 
the ambient light level can result in a faint copy of the input image in the output image. Slight inaccuracies in 
fixturing can introduce jitter which produces artifacts along edges. And noise can result fiom imperfections in 
the acquisition, optics, or fiiom the surface of the object being imaged 

You can compensate for these problems during setup and at runtime. EXuing setup, there are three ways to 
adjust the response of the comparison tool: 

• Normalizing the teir^late and input images 

• Remove extreme values from the image, since these are likely to be noise 

• Building edge tolerance into the template images. 

At runtime, there are two ways to compensate for variations: 

• Setting the absolute level of noise tolerated 

• Setting the spread of variation tolerated. 

Take a common histogram of an image where lighting has been adjusted correctly. The histogram has two 
peaks, representing the features of interest and the background. The mean is the average value of pixels in 
this histogram, and the standard deviation is the overall qjread of the pixel values. The range of the grayscale 
values goes fi-om 0 (dark) to 255 (bright). The histogram of an image is used to normalize its grayscale 
values, both of the input and the template image, so that the con^arisons are less susceptible to noise and 
image lighting variations. There are three different methods available, from fastest to slowest: 

• Greylevel Scaling (or range stretching): adjusts the pixel values of an image to cover the a given 
range of values. The Conpare tool uses full grayscale range. 
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• Mean/StdDev Fitting: Matching the means and standard deviations of the template and input image 
histograms. This method aligns the mean pixel values, and stretches or shrinks the range of the input 
image grayscales to match the range of the template image, as measured by the standard deviation of 
the histogranx 

• Histogram Fitting: Calculates an offset and scaling factor which minimizes the difierence betwe^ the 
curve of the template image histogram and the input image histogram, and therefore a minimum 
difference between their pixel value distributions. This is the slowest method, but the least susceptible 
to noise and artifacts. 

Typically, the extreme left and right tails of such a histogram are susceptible to noise and varying lighting 
conditions, and are unrehable. Before normalizing image grayscales, it is sometimes useful to remove those 
values. The Exclude Extremes or Tail Chpping parameter provides this ability. 


The left tail of the histogram is defined as that gray value to the left of which a user-defined percentage of 
pixels fall (dark pixels), and the right tail of the histogram is defined as tfiat gray value to the right of which a 
user-defined percentage of pixels fall (bright pbcels). Typically, you choose the percentage of pbcels for each 
tail such that the histogram shape between the left and right tails is consistent each time the tool is run. 

Typically, the edges of the object in the template image and in the input image do not exactly align, either 
because of inaccuracy in the fbcturing or because of variation in the object being imaged. 

The Edge Tolerance parameter allows you to set the degree of tolerance in the edge position during training. 
The Edge Tolerance parameter sets the number of fractional pixels by v^ch the edge can vary. During 
training, the compare tool detects edges in the image used to build the tenq)late image, and builds the 
variation into the template image (actually, in the sigma image) where the edges occur. 

At mntime, the input image will have natural low-level variation in the pixel values within an area of constant 
color. This results from noise in the hardware, small variations in lighting, and the cmdeness of the camera 
optics, among other things. This variation is captured partially during the creation of the tenplate and sigma 
images, and is expressed as tolerance in the sigma image. In practice, that capture is imperfect, and it*s 
necessary to provide two methods for adjusting the tolerance. First, you can set an absolute minimum level 
of difference to tolerate. The Noise Tolerance parameter (currently named Basic Tolerance), is the number 
of graylevels of difference to always tolerate. 


Second, you can set how tightly the variation in the training image is applied (viiiere variation is the sigma 
image). The sigma image stores the standard deviation of the neighborhood of each pixel. The Variance 
Tolerance parameter determines how many standard deviations of variation to use. The default, two 
standard deviations, captures 90% of the range of variance, omitting the upper and lower ends of the 
variance- This is useful if the grayscale changes due to lighting variations or object orientation are not uniform, 
and therefore not fully correctable by the global grayscale normalization. 

Setting up the Compare Tool 

1 . Fixture the tool. The compare tool wall not work effectively unless either it is fixtured, or it operates on 
a transformed input image which is itself fixtured 

2. On a training image, set the region to correspond to the part of the input image you wish to use as a 
template. 

3. Choose a Normalization method Choosing no method will simply do an arithmetic comparison of the 
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two images without normalizing the gray levels first 

4. Decide whether or not to clip off outlying pixel values. It can be helpful to histogram the ii^ut region 
to see the distribution of values. Set the Exclude Extremes parameter and clipping percentages 
accordingly. 

5. Set the Edge Tolerance parameter, based on your estimation of the reliability of preciseness of die 
fixturing and the tolerance of the application domain for things that are slightly out of place. 

6. When you exit the tool, it will retrain. This can take several seconds if the template region is large. 

7. Test it by running the job a few times, and moving the object under the camera, to see if the fixturing is 
robust enough. You can adjust the Variance Tolerance and Basic Tolerance (Noise Tolerance) 
parameter without retraining the template, if the trained template and chosen nomialization algorithm 
do not seem to be effective enough (you are seeing large areas reported as defective), 

8. Run the output image through postprocessing to eliminate noise. The image may have salt-and-pepper 
speckles, or faint outlines where there are edges. For many applications, you will want to mn an Open 
with a small kernel, to get rid of the noise. 

9. Run the output image of the postprocessing through blob analysis. Ideally, there should be no blobs, 
or blobs where you want to find them. 

Applications 

• Defect detection, to identify products which vary from an ideal product. 

Use the above setup, with the defects showing up as blobs. This wiU locate missing or misaligned 
parts. 

• Defect detection, to identify damage during processing. 

Set up two jobs to run in sequence. In the first job, an image of the part is acquired before processing, 
and is used as a training image for the Compare tool (the job runs Train for the tool). The second job 
runs after the part returns fix>m the manufacturing process, and runs as a normal template compare. 
Defects introduced will show up as white blobs. One example of this is wafer production processes 
which may chip the wafer. 

• Searching for identifying marks (where those marks are the only thing that changes from instance to 
instance of the imaged object). The training image must be an unmarked instance of the object. The 
location of the mark will show up as a blob in the output of Compare. 

• Sorting similar objects: can be compared to an ideal 'reference' object with Compare. Their 
differences fi-om the ideal will show up as white regions in the output image. Those white regions can 
be measured by the edge or blob tools, and the results used as a basis for sorting. 



^ A ► Image Processing: Getting Started 

In this topic, you define a region of interest, then apply several processing operations to it? this section could 
flow like this? 

► To Process an Image 
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1 . Acquire an appropriate image. For this exercise: 

a. Open the part sample imaf?e„ print it, and return to this topic. Place the printed image under the 
camera. 

b. Click and release A, select Live from the System menu, and click X to enter live mode. 
Interactively adjust the image location, camera height, aperture, and focus until satisfied with the 
image. 

c. CUck A twice to exit live mode, acquire the last image, and retum to the worksheet 
To acquire a new image, hold □ and click X. 

2. Open??? 

3. i^ply a low pass filter to the original image 

4. store th 



^ A ► Image Processing: Understanding 

??Drop this topic?? To process an image, you define an ROI for processing, typically by offsets fiom the 
Fixture row, column, and theta values. You also define a script-like sequence of processing operations to be 
applied within ROI. This section describes the script operations in groups: 

• Image Processing? Filters 


rhe constant-to-image operations apply a fixed integer value to the ROI; the image-to-image operations 
ipply a second pixel value from a buffered image; and the filter operations are neighborhood operations. 


^ A ► Image Processing: Filters 

A filter is an image processing operation that considers the values of surrounding pixels when changing a 
pixel value. The region considered during processing is called the neighborhood or kernel For In-Sight, the 
kemel is always rectangular and controlled by a height and width value. If the kernel has an odd height and 
an odd width. It has a unique center. If it has an even height or width, then ?what happ«is?. ?For In-Sight, all 
pixels mside the kemel count equaUy toward the final result. In-Sight therefore offers the Erode and Dilate 
filters but not a Gaussian blur, which the kanel in a normal distribution.? 

Filters differ in the arithmetical operation applied to the center pixel A low pass filter, for example, changes 
the center pixel to the kemal mean, but an erode filter changes it to the kemal minimum. In-Sight offers the 
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filters that are generally useful and practical. 

?names are based on white features on a dark background? 

LoPass and HiPass Filters 

LoPass and HiPass are related neighborhood-averaging filters. With LoPass, the new center value is the 
average (the arithmetic mean) of the values inside the kernel. LoPass consequently tends to ??. With HiPass, 
XXX. ?spatial only — light and dark make no diff? 

• LoPa.^ passes low-frequency image data and attenuates high-frequaicy data, much like the bass 
control on a stereo. Useful for eliminating dust, scratches and other distractacting defects. The 
underlying algorithm is a neighborhood-averaging filter that sets the pixel at the colter of the kernel to 
the mean within the kernel. 

• HiPass passes high frequency image data and attenuates low-frequency data, much like the treble 
control on a stereo. The underlying algorithm sets the pixel at the center of the kemel to the kernel 
mean minus the original value. (The kemel mean is the LoPass result). The following figure shows 
before-and-afler results for HighPas and LoPass: 


Erode and Dilate Filters 

Erosion is a neighborhood minimum operation. The basis of Close, Open, BotHat, and TopHat. 


• Erode is neighborhood maximum filter that replaces the pixel at the center of the kemel area with the 
smaUest (darkest) grayscale value found there. It therefore tends to increase the size of dark regions 
and decrease the size of light regions, "eroding" them. 

• Dilate Takes its maximum value. 

Open and Close Filters 

Open and Close, derived from Erode and Dilate. The following figure shows TopHat, BotHat, Open, and 
Close: 
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• Close dilates, then erodes — eliminating dark features smaller tfian the kemal. ?Intuition: assuming a 
light image on a daiic background, tends to close up gaps. As a side effect, also increases the size 

• Open erodes, then dilates — eliminating light features smallar than the kernel. 

BotHat and TopHat Filters 

BotHat and TopHat derive from open and close. 

• BotHat calls Close to eliminate small, dark features, then removes all unchanged pixels from the 
resulting image. The final image contains?light? edges from the original image. 

• TopHat calls Open to eliminate small, light features, then removes all unchanged pixels from the 
resulting image. The final image contains ?dark? edges from the original image. 

Edge Direction and Edge Magnitude Filters 

• EdgeDir perfomis ?Sobel Edge Detection? and produce an edge-magnitude image. 

• EdgeMag XXX. 



^ A ► Image Processing: Warping an Image 

L>Sight can waip an image and also translate a point from the warped image back to the unwaiped image- 
To get started with warping, see IVarp Trans forms: Getting Started . 



^ A ► Image Processing: Reference 
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Comparelmaize Trains and compares a stored buffer with an image region, saving a rectangular grayscale 
image segment and threshold template combination for later comparison with new image 
instances. The result of the comparison is typically zero pixel values where the match is 
within tolerance. 

.Neii>hborFiiter Processes a region with a filter that changes each pixel based on the values of neighboring 
pixels. 

PointFilter Processes a region with a filter that changes each pixel independently, ignoring adjacent 

pixels. 

WarpLnage Maps a region of interest into a separate, rectangular image, waiping the region into the 
rectangular result. 


Insight- 


A ► Image Processing: Comparelmage 
function 


Description 


Heading 

Syntax 

Liputs 


Trains and compares a stored buffer with an image region, saving a rectangular grayscale 
image segment and threshold ten^late combination for later comparison with new image 
instances. The result of the comparison is typically zero pixel values where the match is 
within tolerance. 
Vision Processing/Image 

Comparehnage(Image, Fixture, Region, Show) 

Image Image data source, a reference to an Image structure . Default is $A$0. 

Fixture Fixture origin, defined by row, column, and angle offsets, typicaDy to 

— Row compensate for image-to-image variation in position, orientation, or both. 

— Column Row and Column are offsets, in pixels fiom the image origin. Theta is a 
rotation finom the image row axis, ± 360° CCW. Defaults all 0 (the image 
origin). See Workins with Fixtures . 

Region of interest. X and Y define the top-left point by offsets from the 
Fixture origin, in pixels. High and Wide are the height and width, in 
pixels. Angle is a rotation fix)m the Fixture X axis, ± 360° CCW. See 
Defimn^r a Region of Interest . 


-Theta 


Region 
—X 
— Y 
—High 
—Wide 


— Angle 

Normalization Method for nornializing the grayscale values, one of: 

• No Normalization 

• Greylevel Scaling 

• Histogram Fitting 

• Mean/SDev fitting. 


Edge 

Tolerance 

Exclude 


Tolerance built into the template, in tenths of pixels, 0. 10 through 10.00. 
Tail to clq) fiom histogram of input region. One of: 
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Extremes 

• No Tail Clipping 

• Clip Dark Tail 

• Clip Bright Tail 

• Clip Both Tails. 


Dark Tail Percentage of dark histogram tail to ignore 
Bright Tail Percentage of bright histogram tail to ignore. 

Train Flag ON: train on OK or Run, ev en if setup unchanged; OFF: train on OK or 

Run only if setup changed 
Tolerance Acceptable number of standard deviations, 0.00 through 1 0.00. Applied 

at run time. 

Absolute Limit Amount of pixel-level difference always accepted, 0.00 through 10.00. 

Applied at run time. 
Image Shown Flyover image to display. One of: 


• Liput Image 

• Template image 

• Tolerance hnage 

• Output Image. 

Show Selects the graphics to display, as described in Flyover Graphics : 


• Hideall 

• Result graphics only 

• Iiput and result graphics 

• Show all, which displays input, result, and chart (if any) graphics. 


Stores Image On success, an Image structure , which stores the result image. 

Emits XXX 

Errors Invalid parameter. 

Exanple xxx 

Comments None. 

See Also Image structure. Getting Starred with Imase Comporision . 



^ A ► Image Processing: NeighborFilter 
function 
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Etescription 

Heading 

Syntax 

Inputs 


Processes a region with a filter that changes each pixel based on the values of neighboring 
pixels. 

Vision Processing/lmage 

NeighborFilter(Image, Fixture, Region, Clear, Show, Script) 


Image 
Fixture 
— Row 
— Column 
— Theta 

Region 
—X 
— Y 
—High 
— VWde 
— Angle 
Operation 


Image data source, a reference to an linage stnicture . Default is $A$0. 
Fixture origin, defined by row, column, and angle offsets, typically to 
compensate for image-to- image variation in position, orientation, or both. 
Row and Column are offsets, in pixels from the image origin. Theta is a 
rotation from the image row axis, ± 360° CCW. Defaults all 0 (the image 
origin). See IVorkimr with Fixtures , 

Region of interest. X and Y define the top-lefl point by offsets from the 
Fixture origin, in pixels. High and Wide are the height and width, in pixels. 
Angle is a rotation from the Fixture X axis, ± 360"* CCW. See Defhiin<i a 
Region of Interest , 


A filter: One of: 

BotHat Keeps dark features smaller than the kemel. Calls Close 

(to eliminate small, dark features) and then removes aU 
unchanged pixels (leaving the dark features previously 
eliminated). 

Close Keeps bright features larger than the kernel. Calls Dilate 

(to "close" daik g^ in bright features) and then calls 
Erode (to eliminate the increase in feature size). 

Dilate Enlarges light features and reduces dark features. Sets 

the pixel at the center of the kemel to the maximum 
(brightest) grayscale value found there. 

EdgeMagnitude Applies an edge- magnitude /liter, which returns an 

array of values representing the local edge strength, one 
value for each pixel in the ROI. Encodes the edge 
magnitudes between 0 and 63, where 0 is "no edge" and 
63 is "strongest edge." 

Erode Enlarges dark features and reduces bright features. Sets 

the pixel at the center of the kernel to the minimum 
(darkest) grayscale value found there. 

HiPass Keeps features smaller than the kernel and destroys 

features larger than the kemel, attenuating low-frequency 
features. Employs a neighborhood-averaging difference 
filter that sets the pixel at the center of the kemel to the 
kemel mean (the LoPass result) minus the original value 
(to leave the differences). 

LoPass Keeps features larger than the kemel and destroys 

features smaller tfian the kemel, attenuating hi^ 
frequency features. Enploys a neighborhood-averaging 
filter diat sets the pixel at the center of the kemel to the 
mean within the kemel. 
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Stores 
Emits 
Errors 
Comments 
See Also 


Niim Rows 
Num Cols 
Show 


Open Keeps daik features larger than the kernel. Calls Erode 

(to fuse bright gaps in dark features) and then calls Dilate 
(to eliminate the increase in feature size). 
TopHat Keeps bright features smaller than the kernel. Calls Open 

(to eliminate small, bright features) and then removes all 
unchanged pixels (leaving the bright features previously 
eliminated). 
Kernel height, 0 to 255, in pixels. 
Kernel width, 0 to 255, in pixels. 

Selects the graphics to display, as described in Flyover Graphirv 

• Hidean 

• Result graphics only 

• Irq)ut and result graphics 

• Show all, which di:^lays input, result, and chart (if any) graphics. 

Image On success, an hnane stmcture. which stores the processed image. 

The processed image, 
hivalid parameter. 
None. 

Image structure . Geninfr Started with Imane Processii^j 


^ A ► Image Processing: PointFilter function 

Description Processes a region with a filter that changes each pixel independently, ignoring adjacent 
pixels. 

Heading Vision Processing/Image 

Syntax PointFilter(Image, Fixture, Region, Clear, Show, Script) 

Inputs Image Image data source, a reference to an Image stmcture . DefauU is $A$0. 

Fixture Fixture origin, defined by row, column, and angle offsets, typically to 
— Row compensate for image-to-image variation in position, orientation, or both. 
— Column Row and Cohunn are offsets, in pixels fiom the image origin. Theta is a 
rotation from the image row axis, ± 360° CCW. Defaults all 0 (the image 
origin). See Working with FixturpM 

Region of interest. X and Y define the top-lefl point by offsets fiom the 
Fixture origin, in pixels. High and Wide are the height and width, in pixels. 
Angle is a rotation fiom the Fixture X axis, ± 360^* CCW. See Defining a 
Region of Interest , 


— ^Theta 


Region 
—X 
— Y 
—High 
—Wide 
— Angle 
Operation 


A filter. One of: 


Binarize??? 
Clip ???. 
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Equalize??? 

Stretch ??? 
Minimum Minimum gray value. 
Maximum Maximum gray value. 
Threshold Threshold grayscale value. -I for automatic. 
Show Selects the graphics to display, as described in Flyover Graphics : 

• HideaU 

• Result graphics only 

• Input and result graphics 

• Show all, which displays input, result, and chart (if any) graphics. 

Stores Image On success, an Image structure, which stores the processed image. 

Emits Nothing. 

Errors Invalid parameter. 

Comments None. 

See Also Image stmcture. Geitins Starred with Ima^e Processing 


^ A ► Image Processing: Warplmage function 


Description 

Heading 

Syntax 

Inputs 


Stores 
Emits 
Errors 
Comments 

See Also 


Maps a region of interest into a separate, rectangular image, warping the region into the 
rectangular result. 
Vision Processing/Image 
Waiplmage(lmage, Fixture, Region) 


Image 
Fixture 
— Row 
— Column 
— Theta 

Region 
—X 
— Y 
—High 
—Wide 
— Angle 
— Curve 
Image 
??? 

Invalid parameter. 

The warped image is the result of a polar transformation. Any vision tool can use the result 
image as an input image, permitting all tools to process curved parts of the original image. 
TraiisWarpToPixeL Getting Started with Warp Transforms , 


Image data source, a reference to an Image structure . Default is $A$0. 
Fixture origin, defined by row, column, and angle offsets, typically to 
compensate for image-to-image variation in position, orientation, or both. 
Row and Column are oflfeets, in pixels from the image origin. Theta is a 
rotation from the image row axis, ± 360** CCW. Defaults all 0 (the image 
origin). See Working with Fixtures , 

Region of interest X and Y define the top-left point by offsets from the 
Fixture origin, in pbcels. High and Wide are the height and wddth, in pixels. 
Angle is a rotation from the Fixture X axis, ± 360*" CCW. Curve is the 
angle of curvature, ± 360** CCW. (For curved regions, Wide is the arc 
distance at the center of the region.) See Defining a Re<jion of Interest , 


On success, an Image structure , which stores the warped image. 
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^ A ► Input/Output: Overview 

The Input/Output ftinctions read and write to external devices. This section introduces the Input/Output 
functions, discussing the following topics: 

• Getting Started with the Input/Output Functions 

• Input/Output Function Reference . 

Functions in this category support DeviceNet and the ability to save a file to the PC host over the serial port. 


^ A ► Input/Output: Getting Started 

This topic describes how to TBD. 
► To Set Up the Discrete I/O 

1 . Acquire an appropriate image. For this exercise: 

a. Open the part sample image, print it, and return to this topic. Place the printed image under the 
camera. 

b. Click and release A, select Live fix)m the System menu, and click X to enter live mode. 
Interactively adjust the image location, camera height, aperture, and focus imtil satisfied with the 
image. 

c. Click A twice to exit live mode, acquire the last image, and return to the worksheet 
To acquire a new image, hold □ and click X. 

2. tbd. 


^ A ► Input/Output: Function Reference 

DeviceNetRcad Reads data from DeviceNet via a serial port. Returns a DNData structure. 

DeviceNetWrite Writes data to DeviceNet via a serial port. 

DNData structure Stores DeviceNet data. Created by the DeviceNetRcad function. 

Event function Executes on a specified internal, external, or manual trigger, iqxlating all dependent cells. 

Returns an Event structure. 
Event structure Stores an event. Created by the Event function. 
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GetPeviceNetPata Extracts data items read from PeviceNet. 
GetEventValue Returns the parameter value passed to EventQ. 
ReadPiscrete Reads a range of input bits at a specified event. 
ReadPiscreteSingle Reads a single input bit at a specified event 
ReadSerial Reads the serial input at a specified event 

SetEvent Signals a specified event on executioa The source of soft triggers for AcquirelmageQ or 

EventO- 

WritePiscrete Writes a value to a specified range of output bits. 
WritePiscreteSingle Writes a 0 or 1 to a single output bit. 

WriteTmageSerial Copies the current image to a buffer, then sends the buffered image to a serial port. 
WriteSeriai Writes its parameters to the serial output. 



< Input/Output: DeviceNetReadQ 


Description 
Heading 
Syntax 
Inputs 


Reads data fix)m PeviceNet via a serial port. Returns a PNPata structure. 
Input Output/Serial 

PeviceNetRead{Event, Port, MapSpec) 


Event 


Port 

MapSpec 


An event that triggers DeviceNetRead(). Nomially a reference to an Event 
associated with the serial port. Rarely a reference to a cell containing 
Acquirehnage or Button . 
A serial port number, 0 or 1 . 

A list of data specifiers delimited by colon characteis (:). Each specifier has 

two parts: the starting byte (a zero-based byte offset) and a data type 

code. The single-character codes are: 

i 8- or 1 6-bit integer 

u 8- or 1 6-bit unsigned integer 

f 32-bit floating-point 

s string 


For example, "Oi:2f:6u:7s" specifies that the first data item (at offset 0) is a 
16-bit integer, the second item (at offset 2) is a floating-point value; the 
third (at offset 6) is a 1-byte unsigned integer; and the rest of the packet 
(starting at offset 7) is a string. 

Stores DNData On success, a PNPata stmctiu^, which stores the data firom PeviceNet, 

Emits Nothing. 

Errors • Event is not a serial read event. 

• Improperly formatted MapSpec parameter. 

• Mismatch between the MapSpec and the incomming data, specified in the Serial 
I/O settings, through the PeviceNet Petails option. 
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Comments The DeviceNet serial must be connected to a DIP DeviceNet serial communications 

gateway (CDN366). The DIP gateway and DeviceNet Details settings must match. That 
is, both must have the same packet-size setting. In addition, the serial communications 
settings must be the same on both sides. Hardware handshaking is required. 

See Also DeviceNet Write, DNData strucnu-e. GctDcviceNetData . 



^ A ► Input/Output: DeviceNetWriteQ 

Description Writes data to DeviceNet via a serial port. 
Heading Input Output/Serial 

Syntax DeviceNetWrite(Port, MapSpec, Va! ...) 

Inputs Port A serial port number, 0 or 1. 

MapSpec A list of data specifiers delimited by colon characters (:). Each specifier has 

two parts: the starting byte (a zero-based byte offset) and a data type 

code. The single-character codes are: 

i 8- or 16-bit integer 

u 8- or 1 6-bit unsigned integer 

f 32-bit floating-point 

s string 


For example, "0i:2f:6u:7s" specifies that the first data item (at offset 0) is a 
1 6-bit integer; the second item (at offset 2) is a floating-point value; the 
third (at offset 6) is a 1 -byte unsigned integer; and the rest of the packet 
(starting at offset 7) is a string. 
Val „. A variable number of values to write to DeviceNet. 

Returns ??. 

Emits Nothing. 

Errors Invalid parameter. 

Comments None. 

See Also DeviceNet Read. DN Data stmcture. GetDeviceNetData . 



^ A ► Input/Output: DNData structure 

Description Data read fi-om DeviceNet by DeviceNetReadQ- 
Values Value Description Access function 

Data An indexed list of data items. Get DeviceNet Data 

Comments None. 

See Also DeviceNetRead. DeviceNetWrite. DNData stmcture. GetDeviceNetData . 
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^ A ► Input/Output: EventQ 


Description 

Heading 

Syntax 

Inputs 


Returns 
Emits 
En-ors 
Comments 
See Also 


Executes on a specified internal, external, or manual trigger, updating all dependent cells. 
Returns an Event structure, 
liqjut Output 
Event(Trigger, Manual) 

Trigger An internally or externally generated event that updates dependent cells in 
the worksheet To define a soft trigger, see SetEvent 
Enables the manual trigger (Control PadD +X). When enabled, the 
manual trigger does not preempt the specified Trigger. EventQ 
consequently mns at either the manual trigger or the specified Trigger. 


Manual 


??. 
Nothing. 

Invalid parameter. 
None. 

Acquiielmage. Event stiucture, GetEventValue. ReadPiscrete. ReadDiscreteSino le, 
SetEvent WritePiscrete . WritePiscreteSinp le ~ " 


Insight/ 


^ A ► Input/Output: Event structure 


Pescription 
Values 

Comments 
See Also 


Stores an event, used to update the worksheet. Created by EventQ. 

Event has no internal values that are read individually by Data Access functions. It stores 

an event on behalf of other fimctions requiring one. 

The Event function defines an event and stores it in an Event structure. 

Event fimction . GetE\^ntValue^ SetEvent . 


ImSight! 


M A 


► Input/Output: GetDeviceNetDataQ 


Description Extracts data items read over DeviceNet. 

Heading Input Ou^ut/Serial 

Syntax GetDeviceNetData(DN Data, Index) 

Inputs DN Data A reference to data read by PcviceNetRead . 

Index A zero-based index for the data item to extract. 

Returns The data extracted fi*om PN Data. 
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Emits Nothing. 

Errors Invalid parameter. 

Comments None. 

See Also DeviceNetRead. DeviceNetWrite. DNData structure. 


^ A ► Input/Output: GetEi entValueQ 

Description Returns the parameter value passed to EventQ. 

Heading Input Output 

Syntax GetEventValue(Event) 

Inputs Event ???. 

Returns The value passed to EventQ. 

Emits Nothing. 

Errors Invalid parameter. 

Comments None. 

See Also Acquirelmage. Event fimction. Event strucUire. SetEvent . 


^ A ► Input/Output: ReadDiscreteQ 


Description 
Heading 
Syntax 
Inputs 


Returns 
Emits 
Errors 
Comments 


See Also 


Reads a range of ii^ut bits at a specified event 
Input Output/Discrete 

ReadDiscrete(Event, Bit Number, Number of Bits) 

Event Trigger source, a cell-reference. Must be a reference to a cell containing 

AcqulreliTiage (the default). Button, or Event . 
Bit Number First bit number to read, 0 through 7. 
Nura of Bits Number of bits to read, I through 7. 
The value represented by the specified bits. 
Nothing. 

Invalid parameter. 

• This function lets you read a contiguous block of input bits as a unit, returning the 
value collectively represented. For example, if the start bit is 0, the total number of 
bits is 4, and all values are I's, then this function returns 15. 

• To configure discrete input, see Setting up Discrete Input , 

RcadDiscrete. WriteDiscrete. WriteDiscrete . ReadScrial. WriteSerial 
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^ A ► Input/Output: ReadDiscreteSingleQ 


Description Reads a single input bit at a specified event. 

Heading Input Output/Discrete 

Syntax ReadDiscreteSingIe(Event, Bit Number) 

Input? Event Trigger source, a cell reference. Must be a reference to a cell containing 

Acquirelmage (the default), Button, or Event 
Bit Number Bit number to read, 0 through 7. 
Returns The current value of the specified bit, 0.00 or 1 .00 

Emits Nothing. 
Errors Invalid parameter. 

Comments To configure discrete input, see Setting up Discrete Input . 

See Also ReadPiscreteSingie. ReadPiscrete. WriteDiscrete. ReadSerial. WriteSerial 



^ A ► Input/Output: ReadSerialQ 


Pescription 
Heading 
Syntax 
Inputs 


Returns 
Emits 
Errors 
Comments 


Reads the serial output at a specified Event. 
Input Output/Serial 
ReadSerial(Event, Port) 

Event Trigger source, a cell reference. Must be a reference to a cell containing 

Acquirelmaee (the default). Button, or Event 
Port A serial port number, 0 or 1 . 

??The current data, as a string. 
Nothing. 

Invalid parameter. 

• Accepts a variable-length, comma-delimited list of inputs, which are concatenated 
in the order given. 

• To configure the serial port see Setting Un the Serial Port . 


See Also 


ReadPiscrete. ReadPiscreteSingie. WritePiscrete, WriteCHscreteSingle 


^ A ► Input/Output: SetEventQ 
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Description 

Signals a specified event on executioa 

Heading 

Input Output 

Syntax 

SetEvent(Generated Event) 

Inputs 

Generated The event to signal. 


Event 

Returns 

??, 

Emits 

Nothing. 

Errors 

Invalid parameter. 

Comments 

The source of soft triggers for AcquirelmageQ or EventQ. 

See Also 

Acquirelmace. Event ftmction. Event structure, GetE vent Value. 


^ A ► Input/Output: WriteDiscreteO 

Description Writes a value to a specified range of output bits. 
Heading li^ut Output/Discrete 

Syntax WriteDiscrete(Bit Number, Number of Bits, Bit Value) 

Inputs Bit Number First bit number to write, 0 through 7. 

Number of Number of bit numbers to write, 1 through 7. 

Bits 

Bit Value Value to write. The valid range depends on the number of bits written. 7? 
Better name = Write Val?? 
Returns 1 .0 on success or 0.0 on failure. 

Emits Nothing. 
Errors Invalid parameter. 

Comments This function pemiits writing a contiguous block of bits as a unit. For example, if the start 

bit is 0, the total number of bits is 4, and the value written is 15, then all four bits are set to 

rs. 

To configure discrete output, see Sern'm^ up Discrete Output . 
See Also ReadDiscrete. ReadPiscretcSingle. WritePiscrete, ReadSerial. WriteSerial 


^ A ► Input/Output: WriteDiscreteSingleQ 
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Description 

Writes a 0 or 1 to a specified output bit. 

Heading 

Input Output/Discrete 

Syntax 

WriteDiscreteSingle(Bit Number, Bit Value) 

Inputs 

Bit Number Bit number to write, 0 through 7. 


Bit Value Value to write, 0 or 1 . ?Better Name = Write Val? 

Returns 

1 .0 on success or 0.0 on failure. 

Emits 

Nothing. 

Errors 

Invalid parameter. 

Comments 

To configure discrete output see Setting up Discrete Output, 

See Also 

ReadDiscrete. ReadDiscreteSincle. WriteDiscreie. ReadSerial WriteSerial 


COGNEX Insight)' 


^ A ► Input/Output: WritelmageSerialO 

Description Copies the current image to a buffer, then sends the buffered image to a serial Port 
Heading Input/Output 

Syntax WriteImageSerial(Image, Port, Name) 

Inputs Image The image to save. A reference to an Image structure. 

Port Serial port. 0 or 1 . 

Name A name for tfie file. A text string. 

Returns ??? ???. 

Emits Nothing. 

Errors Image buffer occupied because a previous WritelmageSerialQ operation is not done 

moving the image over the serial port. 
Comments To avoid su^jending image acquistion and processing while saving the image — a 

potentially slow operation — WritelmageSerialO^ 

1 . Copies the current image to a buffer 

2. Spools the buffered data through the specified serial port. 


See Also 


Calling WritelmageSerialQ a second time before the file copy operation has completed 

yields an error 

None, 


^ A ► I/O: WriteSerialO 
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Description 
Heading 
Syntax 
Inputs 

Returns 
Einits 
Errors 
Comments 


See Also 


Writes its parameters to the serial output. 

Input Output/Serial 

WriteSerial(Poit, String) 

Port A serial port number, 0 or 1 . 

String String to write to Port. 

1 .0 on success or 0.0 on failure. 

Nothing. 

??Invalid ???. 

Accepts a variable-length, comma-delimited list of inputs, which are concatenated in the 
order given. 


To configure the serial port for ou^ut, use SerialO- 

ReadPiscrete. ReadPiscreteSinele. WritePiscrete. WritePiscrcte. ReadSerial . 


Insight;* 
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^ A ► Math: Overview 

The Mathematics functions offer standard mathematical operations, ananged under the following headings: 

Logic Logical AND, OR, and NOT; bitwise AND, OR, XOR, and NOT; range checking. For 

all logical functions, 0.00 is FALSE and non-0,00 is TRUE. 
Lookup Finds values in lists. Includes IfO» for conditional formulas; also functions that get the row 

and column index of a worksheet cell. 
Math Arithmetical functions. Confutes absolute values, sums, modulus, random numbers, 

square roots, and so on. 

Operators Relational operators. Their precedence is the same as in ANSI C. (Logical and bitwise 
operators are implemented as functions under the Logic heading.) 

Trigonometry Functions involving angles. Offers sine, cosine, tangent, arc sine, arc cosine, and arc 
tangent; also offers pi and conversions between radians and degrees. 

Statistics Standard statistical functions: arithmetical mean, standard deviation, maximum, and 

minimum 

This section introduces the Mathematics functions, discussing the following topics: 

• Getting Started with the Mathematics Fiuictions 

• Operators Reference 

• Mathematics Function Reference . 

To assure compatibility of all numeric values in the worksheet, In-Sight represents all numbers as floating- 
point values. For exanple, it represents the integer 3 as 3.00. Similarly, for logical functions, it represents 
TRUE as non-0.00 and FALSE as 0.00. Eliminating the need for explicit numeric data types simplifies the 
task of developing spreadsheets for vision applications. 

NOTES • Some values are intrinsically integer. Siqjplying a fiactional value for an integer parameter 
results in rounding to the nearest whole integer. For example, 3.1 rounds to 3.000, but 3.7 
rounds to 4.000. 

• In-Sight's underfying precision (32-bit floating-point) exceeds its displayed precision (three 
decimal places). Computations on floating-point values reflect the internal precision. 

• An empty cell referenced as a numeric or Boolean value is interpreted as 0.0. For example, 
if A 1 is empty, then Abs(Al) yields 0.0. 

=— — — — — CX3GMEX ln(Sighi. 

^ A ► Math: Getting Started 

Apphcations commonly use the Mathematics functions in formulas that process feature values from vision 
tools. This exercise illustrates the use of the If function — which returns one value if its first parameter 
evaluates to TRUE (non-0.00) and another value if it evaluates to FALSE (0.00) — to test the contrast value 
fix>m a histogram. In this exercise, IfQ prints PASS when the contrast is greater than or equal to 50. 
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Otherwise, it prints FAIL, The results look like this: 









































y Conditional result . / 




mitmm 












Formula 


Tested 
^ value 


^ To Use IfQ to Display a Conditional Message 

1 . Acquire an appropriate image. EXiring development, you typically place a part sample under the test 
stand and snap a picture of it . Alternatively, to adjust the camera height, aperture, and focus, use live 
mode . 

2. Before you can test a value, you have to have a value to test. A convenient value for this exercise is 
the contrast result fiiom a histogram. To obtain it: 

a. From cell A2, click Xto open the Fomitila Builder . 

b. From Vision Processing, open the Histogram heading, and then open the ExtractHistogram 
property sheet. 

c. Click X on the Region heading, switching to the interactive Region cursor. Use the Control Pad 
to adjust the region to enclose a feature in the image. 

d. Click X to accept the region, and then click OK to close the property sheet 
ExtractHistogramQ computes the histogram, returns a Hist structure, and emits the contrast and 
other values. 

3. Move to cell A3, and then click Xto open the Formula Builder. 

4. From Mathematics, open the Lookup heading, select !£ and click X In-Sight places IfO in the 
formula bar, leaving the Formula Builder open. Most Mathematics flmctions don't have property 
sheets. You directly edit their parameters. 

For the firet param eter (the condition), construct the formula G2>=50 as follows: 


5. 


6. 

7. 
8. 
9. 
10. 


11. 


a. 
b. 
c. 
d. 
e. 


m 


Click L^, the relative reference button. 
Move the marquee to cell G2, the histogram contrast. Click X to accqjt the reference. 
From Mathematics, open the Operators heading, select >=, and click X 
From the keypad, enter 50. 

From the keypad, enter a comma (the delimiter between the first and secon d parameters). 


For the second parameter, which is the result wiien TRUE (non-O.OO), click Ifel to open the Text 

Entry dialog. Edit the string "PASS", and click OK to accept it. 

From the keypad, enter a comma as a delimiter between the parameters. 

For the third parameter, the result when FALSE, similarly edit "FAIL" and click OK. 

From the keypad, enter a close-parenthesis character to mark the end of IfQ's last parameter 

Click OK to close the Formula Builder. hi-Sight evaluates the formula and prints PASS or FAIL in 

cell A3, depending on the value of cell G2. Provided the region of interest for ExtractHistogramQ 

contains an appropriate feature, you probably get a PASS result. 

You now have a working formula containing a Mathematics function and a Mathematics operator. To 
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get a better sense of its behavior, try this: 

a. Chck and release A to open the System menu. Select Triggers to open the Triggers menu, and 
then enable the Continuous option. L>Sight acquires images as quickly as possible, 
reevaluating the IfO fomiula for each image. 

b. Put a blank sheet of paper in front of the camera. The contrast should drop below 50. The 
formula prints FAIL until you remove the paper. 


^ A ► Math: Operators Reference 

The Operators heading lists the relational operators. Their precedence is the same as that in the ANSI C 
language. Logical and bitwise operations are available as functions, not as operators. 

only curators that are valid in the cunrent context. Invalid operators are 

Description 

Entered from Formula Builder keypad, not from the Operators list 
The Sum function is an alternative in some contexts- 
Entered from Fomiula Builder keypad not from the Operators list. 
Modulus is available tfirough the Mod fimctioa 


NOTE The Formula Builder lists 

unavailable. 
Symbol Name 
+ Addition 

/ Division 


> 
< 


<= 
* 


Equality 
Inequality 
Greater than 
Less than 

Greater than or equal to 
Less than or equal to 
Multiplication 
Subtraction 
Unary minus 


Entered from Fonnula Builder keypad, not from the Operators list. 
Entered from Fonnula Builder keypad, not from the Operators list. 
Entered from Formula Builder keypad, not from the C^)erators hst. 


^ A ► Math: Function Reference 


Abs Returns the absolute value of a specified value. 

ACos Returns the arc cosine angle in degrees. 

And Returns the logical AND of a variable-lengdi list of values. 

ASin Returns the arc sine angle in degrees. 

ATan Returns the arc tangent angle in degrees, ± 90. 

ATan2 Returns the arc tangent angle, ± 1 80 degrees, of the vector (DY JDX). 

BitAnd Returns the bitwise AND from its parameters. 
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BitNot 

Returns the bitwise inverse of its parameter- 

BitOr 

Returns the bitwise OR of its parameters. 

BitXor 

Returns the bitwise exclusive OR of its parameters. 

Ceilinc 

Truncates a floating-point value to an integer. Truncates up, yielding the next-largerinteger. 

Choose 

Returns the value of the indexed parameto-. Takes an integer index followed by a variable 


number of floating-point values (the array). 

Column 

Returns the column number of a worksheet cell. Column A is 0.0, B is 1 .0, and so oa 

Cos 

Returns the cosine, given an angle in degrees. 

CountEiTor 

Returns number of errors in one or more cells or ceU ranges. 

Decrees 

Converts from radians to degrees. 

Exp 

Returns e, the base of the natural logarithms, raised to a specified power. 

If 

Tests its first parameter, returning one value if it is TRUE (non-0.00) and another value if it 


is FALSE (0.00). 

InRange 

Returns TRUE (1 .00) if a specified value is within a specified range. 

Jnt 

Truncates a floating-point value to an integer. Truncates down, yielding the next-smaller 


integer. 

Max 

Returns the maximum value from a variable number of values. 

MaxI 

Returns the zero-based index of the maximum value from a variable number of values. 

Mean 

Returns the mean (average) from a variable number of values. 

Min 

Returns the minimum value from a variable number of values. 

Mini 

Returns the zero-based index of the minimum value from a variable number of values. 

Mod 

Returns the remainder of Val2 divided by Val 1 . 

Not 

Returns the logical inverse of its argument 

Or 

Returns the logical OR of a variable-length list of arguments. 

£i 

Returns the value of pi. 

Power 

Returns a specified value to a specified power. 

Radians 

Converts from degrees to radians. 

Rand 

Returns a random number between 0.00 and 1 .00, updating it at a specified event. 

Round 

Rounds a floating-point value the nearest integer value. 

Row 

Returns the row number of a worksheet cell. 

SDev 

Returns the standard deviation of a variable number of values. 

Sin 

Returns the sine, given an angle in degrees. 

Sqrt 

Returns the square root of a specified value. 

Sum 

Returns the sum of a variable number of values. 

Tan 

Returns the tangent, given an angle in degrees. 

Trunc 

Truncates a floating-point value to an integer. Truncates toward zero, yielding the original 


value without the fiaction. 



^ ▲ ► Math: Abs function 
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Description Returns the absolute value of a specified value. 

Heading Mathematics/Math 

Syntax AbsfVal) 

Inputs Val An expression that evaluates to a floating-fK>int value. 

Returns Absolute value of Val, as a floating-point value. 

Emits Nothing. 

Errors Invalid parameter, for instance a reference to a string or an cttot, 

Exanple Abs(-10) returns 10.00. 

Comments None. 

See Also Exp, fnt Mod. Power , Rand Sqrt. Sum . 



^ A ► Math: ACos function 


Description Returns the arc cosine angle in degrees. 
Heading Mathematics/Trigonometry 
Syntax ACos(Val) 

Inputs Val An expression that evaluates to a floating-point value. Valid range, -1 .00 

through +1.00. 

Returns Arc cosine angle in degrees, as a floating-point value. 

Emits Nothing- 
Errors • Val is out-of-range 

• Val is invalid. For example, it is a reference to a string or to an enx>r. 

Example ACos(- 1 ) returns 1 80.00. 

Comments None. 

See Also ASin. ATan, ATan2. Cos, Degrees. Pi. Radians. Sin. Tan . 


^ A ► Math: And function 


Description Returns the logical AND of a variable-length list of values. 
Heading Mathematics/Logic 
Syntax And(Vall, Val2 . . . ) 

Inputs Vail ... A variable-length, comma-delimited list of valxies. Each vahie can be a cell 

reference, a cell range, or a floating-point value. 
Returns Logical AND of Vail . . . VaIN: TRUE (1 .00) if all parameters are TRUE (non-0.00), 

and FALSE (0.00) if any parameter is FALSE (0.00). 
Emits Nothing. 

Errors #ERR if all parameters are invalid. 
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Exanple 


And( 1,2,3) returns LOO. 


And(0,l) returns 0.00. 

Comments • AndQ letunis a value if at least one parameter is a valid numeric value. It ignores 

individual parameters that refer to empty cells or error cells and processes the valid 
parameters. If all parameters are invalid, AndQ returns an error. 
• All non-0.00 inputs are treated as 1 .00. 


See Also 


BitAnd BitNot. BitOr. BitXor. InRanae. Not. Or . 


^ A ► Math: ASin function 


Description Returns the arc sine angle in degrees. 

Heading Mathematics/Trigonometry 

Syntax ASin(Val) 

Inputs Val An expression that evaluates to a floating-point value. Valid range, -1 .00 

through +1.00. 

Returns The arc sine angle in degrees, as a floating-point value. 

Emits Notfiing. 

Errors Val out of range. 

Example ASin( 1 ) returns 90.00. 

Comments None. 

See Also ACos, ATan, ATan2. Cos, Degees, Pi, Radians. Sin. Tan . 


^ A ► Math: ATan function 


Description Returns the arc tangent angle in degrees, ± 90. 

Heading Mathematics/Trigonometry 

Syntax ATan(Val) 

Inputs Val An expression that evaluates to a floating-point value. 

Returns Arc tangent angle, ± 90 degrees, as a floating-point value. 

Emits Nothing. 

Errors ??None. 

Example ATan( 1 ) returns 45 .00. 

Comments None. 

See Also ACos, ASin, ATan2, Cos, Degrees. Pi , Radians. Sin. Tan . 


COGIMEX IntSighii 
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Math: ATan2 function 

Returns the arc tangent angle, ± 1 80 degrees, of the vector (DY,DX). 

Mathematics/Trigononietry 

ATan2(Vali,Val2) 

Vail DY, an expression tiiat evaluates to a floating-point ^/alue. 

Val2 DX, an expression that evaluates to a floating-point value. 

Arc tangent angle, ± 1 80 degrees, as a floating-point value. 
Nothing. 

??Vall and Val2 both equal 0.00. 
ATan2(l ,1) returns 45.00. 
None. 

A Cos. ASiru ATan. Cos, Degrees. Pi, Radians. Sin. Tan . 



^ ▲ ► 

Math: Bit And function 


Description 

Returns the bitwise AND of its parameters. 


Heading 

Mathematics/Logic 


Syntax 

BitAnd(Vall, Vai2) 


Inputs 

Vail An e?q>ression that evaluates to a floating-point value. 



Val2 An expression that evaluates to a floating-point value. 


Returns 

Bitwise AND of Vail . . . ValN. 


Emits 

Nothing. 


Errors 

??Vall or Val2 is out of range. 


Example 

BitAnd(3,10) returns 2.00. 


Comments 

Processes only the lower the 16 bits of Vail and Val2. Ignores the upper 16 bits. Result is 


a 1 6-bit unsigned integer. 


See Also 

AiKi BiiNot BitOr, BitXor. InRange. Not. Or. 



COGIME> 



^ A ► 

Description 
Heading 
Syntax 
Inputs 

Returns 

Emits 

Enrors 

Exanple 

Comments 

See Also 


^ A ► Math: BitNot function 


Description Returns the bitwise NOT of its parameter. 

Heading Mathanatics/Lx)gic 

Syntax BitNot(Val) 

Inputs Val An expression that evaluates to a floating-point value. 

Returns Bitwise NOT of VaL 

Emits Nothing. 
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Errors 

f f vai IS oui oi range. 


xjiiiNoni 7 reuirns — z.uu. 

Comments 

Processes only the lower 16 bits of Val. Ignores the upper 1 6 bits. The result is a 16-bit 


unsigned integer. 

See Also 

Ana, rsitAno, oitur. tfitAor. inKanize. (Jr. Not. 

^^^^^^^ avw^^ 1 1 J 

~ .J^ 

CaC3NEX Intoignl 

Math* RitOr fnnrfinn 

Description 

Returns the bitwise OR of its parameters. 

Heading 

Mathematics/Logic ' 

Syntax 

BitOr(Vall, Val2) 

Inputs 

Vail An expression that evaluates to a floating-point value. 


Val2 An expression that evaluates to a floating-point value. 

Returns 

Bitwise OR of Argl and Arg2. 

Emits 

Nothing. 

En^ors 

??Vall or Val2 is out of range. 

Example 

BitOr(3,10) returns 1 1.00. 

Comments 

Processes only the lower 16 bits of Vail and Val2. Ignores the upper 16 bits. The result 


is a 16-bit unsigned integer. 

See Also 

And BitAnd BitNot, BitXon LiRantie. Not. Or. 



^ ▲ ► 

Math: BitXor function 

Description 

Returns the bitv^se exclusive OR of its parameters. 

Heading 

Mathematics/Logic 

Syntax 

BitXor(Argl, Arg2) 

Inputs 

Argl An expression that evaluates to a floating-point value. 


Arg2 An expression that evaluates to a floating-point value. 

Returns 

Bitwise exclusive OR of Argl and argN. 

Emits 

Nothing. 

Errors 

??Vall or Val2 is out of range. 

Exanple 

BitXor(6, 10) returns 12.00. 

Comments 

Processes only the lower 16 bits of Vail and Val2. Ignores the upper 16 bits. The resuh 


is a 16-bit unsigned integer. 

See Also 

And BitAnd BitNot. BitOr, InRanse, Not. Or. 
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^ A ► Math: Ceiling function 


Description 

Heading 

Syntax 

Inputs 

Returns 

Emits 

Errors 

Exarrple 


Comments 


Truncates a floating-point value to an integer. 

Mathematics/Math 

Int(Val) 

Val An expression that evaluates to a floating-point value. 

An integer truncated fiom Val. 

Nothing. 

??None. 

• lnt(5.995) returns 5.00. 

• Int( 1,6) returns 1.00 

• Int(-1.2) returns -2.00 

• CeilingO truncates up to the next-larger integer. In contrast, Int() tnmcates down to 
the next-smaller integer; TnincQ truncates toward zero; and RoundQ returns the 
nearest integer 


Value 
1.2 
1,2 
3,6 
-3,6 


CeilingO 

2.00 
-2.00 
4.00 
-4.00 


1.00 
-2.00 
3.00 
-4.00 


Into 


RoundO 

1.00 
-1.00 
4.00 
-4.00 


TruncO 

1.00 
-1.00 
3.00 
-3.00 


See Also 


In-Sight expresses integer values in floating-point fonnat For example, the integer 
value 5 is displayed as 5.00. 

Abs, Exp. Int. Mod. Power. Rand Round, Sqrt. Sura Trunc. 


^ A ► Math: Choose function 


Description 

Heading 

Syntax 

Inputs 


Returns 
Emits 


Returns the value of the indexed parameter. Takes an integer index followed by a variable 
number of values (the array). 
Mathematics/Lookup 
Choose(hidex, ValO, Vail , . . .) 

Index Index into the list. Zero-based, so ValO is 0, Vail is 1 , and so on. 

ValO ... A variable-length, ccmma-delimited list of values. Each value can be a cell 

reference, a cell range, a string, or a floating-point value. 
Value of the parameter at Index, as a floating-point value. 
Nothing. 
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Errors 


Exanple 
Comments 


• Index is not a positive integer, or does not exist in the list. For example. Choose 
(100, 2, 3) returns #ERR. 

• All members of the list are invalid. 

• The selected list item is an error. For example, Choose(0, #ERR, 4) returns #ERR, 
reflecting the indexed item. 

Choose(2, 7, 6, 13, 2) returns 13.00. 

• ChooseO assigns indexes to any parameters that are empty cells or error cells and 
propagates their empty or error value if selected For example, Choose(0, #ERR, 
10) returns #ERR, and Choose(0, empty, 10) returns empty. 

• If a list item is a cell range, then Choose() expands the range into its elements and 
assigns an index to each element For example, Choose(l, A1:A4, DIO) is 
interpreted as Choose(l, Al. A2, A3, A4, DIO) and returns the value of A2, 
selected by the zero-based index of 1 . 


See Also 


Column, I£ Maxl, Mini, Row . 


A ► Math: Column function 


Description Returns the column number of a worksheet cell. 

Heading Mathematics/Lx)okup 

Syntax Column(Cell) 

li^uts Cell A reference to a worksheet cell. 

Returns The column number of Cell. Each column has a zero-based index, so column A is 0.0, B 

is 1 .0, and so on. 

Emits Nothing. 

Errors None. 

Exan^le Column(B2) returns 1 .00. 

Comments None. 

See Also Choose. 1£ MaxI, Mini. Row . 


^ A ► Math: Cos function 


Description Returns the cosine, given an angle in degrees- 
Heading Mathematics/Trigonometry 
Syntax Cos(Angle) 

Inputs Angle An angle, in degrees. An expression that evaluates to a floating-point value. 

Returns Cosine of Angle, in degrees. 

Bnits Nothing. 
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Errors ??None. 

Example Cos( 1 80) returns -I . 

Comments None. 

See Also ACos, ASin, ATan, ATan2, Degrees. Pi. Radians. Sin. Tan , 


CC3GIMEX In^ighi) 


^ A ► Math: CountError function 


Description 

Returns number of errors in one or more cells or cell ranges. 

Heading 

Mathematics/LookiqD 

Syntax 

CountError(Cell-Ref, [ CeU-Ref . . .] ) 

Inputs 

Cell-Ref A cell or cell range. 

Returns 

The number of errors in the specified cells. 

Emits 

Nothing. 

Errors 

None. 

Comments 

None. 

See Also 

Choose, ff. 



A ► Math: Degrees function 


Description Converts from radians to degrees. 

Heading Mathematics/Trigonometry 

Syntax Degrees(Radians) 

Inputs Radians An angle in radians, expressed as a floating-point value. 

Returns Angle in degrees. 

Emits Nothing. 

Errors ??None. 

Exanple Degrees(3. 14) returns 179.908. 

Comments None. 

See Also ACos, ASin. ATan, ATan2, Cos. Pi . Radians. Sin . Tan . 


CXX3IMEX IntSightj 


^ ▲ ► Math: Exp function 
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Description Returns e, the base of the natural logorithms, raised to a specified power. 

Heading Mathematics/Math 

Syntax E;q)(Val) 

Inputs Val The exponant An expression that evaluates to a floating-point value. 

Returns e raised to the Val power. 

Emits Nothing. 

Errors ?? Val is out of range? WHAT IS THE RANGE?? 

Exanple Exp( 1 ) returns 2.718. 

Comments None. 

See Also Abs, Int Mod. Power. Rand Sqrt. Stun . 


^ A ► Math: If function 


Description 

Heading 

Syntax 

Inputs 


Returns 

Emits 
Errors 
Example 


Tests its first parameter, returning one value if it is TRUE (non-0.00) and another value if it 
is FALSE (0.00). 
Mathematics/Lookup 
If(Cond, Vail, Val2) 

Cond Condition for IfO, an expression that evaluates to a floating-point value. 

TRUE is non-0.00 and FALSE = 0.00. 
Vail Result, when Cond is TRUE (non-0.00). 

Val2 Result, when Cond is FALSE (0.00). 

Vail If Cond is TRUE (non-0.00). 

Val2 If Cond is FALSE (0,00). 

Nothing. 
??None. 

. IftU 1,2) returns 1.00. 

• IfCO/Tnie", "False") returns "False". 

• Ifl[5, 3, 7) returns 3.00. 

. lf($G$2>=50, "PASS", "FAIL") returns PASS or FAIL, depending on the current 
value of cell $G$2. 


Comments None. 

See Also Choose. Column. Maxl. Mini Row. Usini^ the Kfathematics Functions. 


ln(Sight) 


^ A ► Math: InRange function 


SDOCrO; <WO 01 1 1 445A2J_> 


Appendix I - Page 253 


wo 01/11445 


PCT/USOO/22383 


Description Returns TRUE ( 1 .00) if a specified value is within a specified range. 


Heading 

Mathematics/Lx>gic 

Syntax 

InRange(Val, Min, Max) 

Inputs 

Val 

Value to test An expression that evaluates to a floating-point value. 

Min 

Minimum — the bottom of the range. An expression that evaluates to a 



floating-point value. 


Max 

Maximum — the top of the range. An expression that evaluates to a floating- 



point value. 

Returns 

1.00 

Val is within the range (Min <= Val <= Max). 


0.00 

Val is not within the range. 

Emits 

Nothing. 


Errors 

??None. 


Exarrple 

lnRange(3, 

1,9) returns 1.00. 

Comments 

None. 


See Also 

And BitAnd BitNot BitOr, BitXor, Or, Not. 


^ A ► Math: Int function 


Description Truncates a floating-point value to an integer. 
Heading Mathematics/Math 
Syntax Int(Val) 

Inputs Val An expression that evaluates to a floating-point value. 

Returns An integer tmncated fiom Val. 

&nits Nothing. 

Errors ??None. 

Example • Int(5. 995) returns 5.00. 

• Int( 1.6) returns 1.00 

• Int(-1.2) returns -2.00 


Comments 


Into tmncates down to the next-larger integer. In contrast, CeilingQ truncates up to 
the next-larger integer; TruncQ truncates toward zero; and RoundQ returns the 
nearest integer: 


Value 
1.2 
1.2 

3.6 
-3.6 


CeilingO 

2.00 
-2.00 
4.00 
^.00 


Into 


1.00 
-2.00 
3.00 
-4.00 


RoundQ 

1.00 
-1.00 
4.00 
^.00 


TruncO 

1.00 
-1.00 
3.00 
-3.00 


In-Sight expresses integer values in floating-point fomiat For example, the integer 
value 5 is displayed as 5.00. 

Into is similar to the C-language function called FloorO- Both are the "opposite" of 
CeilingO. 
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See Also 


Abs, Ceiling. Exp, Mod. Powen Rand, Round, Sqii. Siim, Tninc . 


^ A ► Math: Max function 


Description 
Heading 
Syntax 
Inputs 

Returns 

Emits 

Errors 

Exanple 

Comments 


See Also 


Returns the maximum vahje fix>m a variable number of values. 

Mathematics/Statistics 

Max(Vall, Val2 ...) 

Vail ... A variable-length, comma-delimited list of values. Each value can be a cell 

reference, a cell range, or a floating-point value. 
The largest value fiom the list 
Nothing. 

#ERR if all parameters are invalid. 
Max(l, 2,3.4) returns 4.00. 

Max() returns a value if at least one parameter is a valid numeric value. It ignores 
individual parameters that refer to empty cells or error cells and processes the valid 
parameters. For example, Max(l, #ERR, 2, empty, 3) returns 3, which is the maximum of 
1, 2, and 3. If all parameters are invalid, Max() returns an error. 
Maxl. Mean. Mig MinT, SDev . 


^ A ► Math: MaxI function 


Description 

Returns the zero-based index of the maximum value from a variable number of values. 

Heading 

Mathematics/Lx)okup 

Syntax 

MaxI(Va]l, Val2 ...) 

Inputs 

Vail ... A variable-length, comma-delimited list of values. Each value can be a cell 


reference, a cell range, or a floating-point value. 

Returns 

Zero-based index of the largest value from the list. If there is more than one instance of the 


largest value, returns the index of the first instance. 

Emits 

Nothing. 

Errors 

#ERR if all parameters are invalid 

Exairple 

Maxl(l ,2,3,4) returns 3.00. 

Comments 

• The indexes are zero-based, so the index of Vail is 0.0, the index of Val2 is 1.0, 


and so on. 


• MaxIQ returns a value if at least one parameter is a valid numeric value. Individual 
parameters that refer to empty cells or error cells are assigned indexes, but MaxIQ 
ignores them when seeking the maximum. For example, Maxl{I , #ERR, 2, empty, 
3) returns 4.00, which is the index of 3, the largest valid value on the list If all 
parameters are invalid, MaxIQ returns an error. 
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See Also 



^ A ► Math: Mean function 


Description 
Heading 
Syntax 
Inputs 

Returns 

Emits 

Enrors 

Example 

Comments 


See Also 


Returns the mean (average) from a variable number of values. 

Mathematics/Statistics 

Mean(Vall,Val2...) 

Vail * . . A variable-length, comma-delimited list of values. Each value can be a cell 

reference, a cell range, or a floating-point value. 
Arithmetic mean of from the list 
Nothing- 

#ERR if all parameters are invalid. 
Mean(5, 7, 9) returns 7.00. 

MeanO returns a value if at least one parameter is a valid numeric value. It ignores 
individual parameters that refer to ernpty cells or error cells and processes the valid 
parameters. For example, Mean{l, #ERR, 2, empty, 3) returns 2, which is the average of 
1 , 2, and 3. If all parameters are invalid, Mean() returns an error. 
Max. IVtin, SDev . 


^ A ► Math: Min function 


Description 
Heading 
Syntax 
Inputs 

Returns 

Bnits 

Errors 

Exanple 

Comments 


See Also 


Returns the minimum value from a variable number of values. 

Mathematics/Statistics 

Min(Vall,Val2 ...) 

Vail * . . A variable-length, comma-delimited list of values. Each value can be a cell 

reference, a cell range, or a floating-point value. 
Smallest value from the list 
Nothing. 

#ERR if all parameters are invalid. 
Min( 1, 2,3,4) returns 1.00. 

MinO returns a value if at least one parameter is a valid numeric value. It ignores individual 
parameters that refer to empty cells or error cells and processes the vabd parameters. For 
example, Min(l, #ERR, 2, empty, 3) returns 1, which is the minimum of 1, 2, and 3. If all 
parameters are invalid, MinQ returns an error. 
Max, MaxI, Mean. Mini, SDev . 
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^ A ► Math: Mini function 


Description Returns the zero-based index of the minimum value from a variable number of values. 
Heading Mathematics/Lookup 
Syntax MinI(Val 1 , Val2 . . .) 

hiputs Vail ... A variable-loigth, comma-delimited list of values. Each value can be a cell 

reference, a cell range, or a floating-point value. 
Returns Zero-based index of the smallest value from the list. If there is more than one instance of 

the smallest value, returns the index of the first instance. 
Emits Nothing. 

Errors #ERR if all parameters are invalid 

Exanple Minl( 1,2,3,4) returns 0.00. 

Comments • The indexes are zero-based, so the index of Vail is 0.0, the index of Val2 is 1 .0, 

and so on. 

• MinlQ returns a value if at least one parameter is a valid numeric value. Individual 
parameters that refer to empty cells or error cells are assigned indexes, but MinlQ 
ignores them when seeking the minimum. For example, Minl(l , #ERR, 2, empty, 3) 
returns 0.0, which is the index of 1, the smallest valid value on the list. If all 
parameters are invahd, MinlQ returns an error. 

See Also Choose, Column. !£ Max. Max!. Min, Row . 


^ A ► 

Math: Mod function 

Description 

Returns the remainder of Val 1 divided by Val2. 

Heading 

Mathematics/Math 

Syntax 

Mod{Vall, Val2) 

Inputs 

Vail An expression that evaluates to a floating-point value. 


Val2 An expression that evaluates to a floating-point value. 

Returns 

Modulus (remainder) of Vail divided by Val2, as a floating-point value. 

Emits 

Nothing. 

Errors 

Val2 equals 0.00. 

Exanple 

Mod(5,12) returns 2.00. 

Comments 

None. 

See Also 

Rm Int Power. Rand Sqrt. Sum. 



^ A ► Math: Not function 
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Description 

Heading 

Syntax 

Inputs 

Returns 

Emits 
Errors 


Returns tbe logical inverse of its argument 

Mathematics/Logic 

Not{Val) 

Val An expression that evaluates to a floating-point value. 

Logical NOT of Val: TRUE (LOO) for FALSE (0.00), and FALSE (0.00) for TRUE 

(non-0-00). 

Nothing. 

#ERR if Val is invalid, for example a reference to a string. 
Not(l) returns 0.00 


Not(O) returns LOO. 

Comments All non-O.OO inputs are treated as LOO and therefore remm 0.00. 
See Also And, BitAnd BitNot. BitOr. BitXor. InRange. Or . 


In(i5fght) 


^ A ► Math: Or function 


I>escription 
Heading 
Syntax 
Inputs 

Returns 

Emits 
Errors 
Example 


Comments 


See Also 


Returns the logical OR of a variable-length list of values. 

Mathematics/Logic 

Or(ValI, Val2 ...) 

Vail ... A variable number of values. Each value can be a cell reference, a cell 

range, or a floating-point value. 
Logical OR of Vail . . . ValN. TRUE (1 .00) if any parameter is TRUE (non-O.OO), and 
FALSE (0.00) if all parameters are FALSE (0.00). 
Nothing. 

#ERR if all parameters are invalid. 
Or(0,l) returns 1.00. 

Or(0,0) returns 0.00. 

• Or() returns a value if at least one parameter is a valid numeric value. It ignores 
individual parameteis that refer to err^ty cells or error ceUs and processes the valid 
parameters- If all parameters are invalid, Or() returns an error. 

• All non-O.OO inputs are treated as 1 .00. 

And. BitAnd BitNot. BitOr. BitXor. InRange. Not . 


^ A ► Math: Pi function 
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Description 

Returns the value of pi. 

Heading 

Mathematics/Trigonometry 

Syntax 

Pi 

Inputs 

None. 

Returns 

3.14159... (the 32-bit, floating-point value of pi). 

Emits 

Nothing. 

Errors 

None. 

Exanple 

Pi returns 3.141159..., displayed as 3.141. 

Comments 

None. 

See Also 

ACos, ASin, ATan, ATan2. Cos. Decrees, Radians, Sin. Tan. 



A ► Math: Power function 


Returns a specified value to a specified power. 

Mathematics/Math 

Power(Base, Exp) 

Base The base, an expression that evaluates to a floating-point value. 

Exp The ex|x>nent, an expression that evaluates to a floating-point value. 

Base to the Exp power. 
Nothing. 

??Base or Exp is an invalid number. 
Power(5,5) returns 3,125. 
None. 

Abs, Exp, Int Mod, Rand Sqrt , Sum . 



^ A ► Math: Radians function 


Description Converts from degrees to radians. 

Heading Mathematics/Trigonometry 

Syntax Radians(Degrees) 

Inputs Degrees An angle in degrees, to be converted to radians, expressed as a floating- 
point value. 

Returns The radians equivalent of Degrees, expressed as a floating-point value. 

Emits Nothing. 

Errors ??None. 

Example Radians(180) returns 3.141, the 32-bit floating-point value of pi. 

Comments None. 

See Also ACos, ASin: ATan , ATan2, Cos. Degrees, Pi , Sin, Tan . 


Description 
Heading 
Syntax 
Inputs 

Returns 

Emits 

Errors 

Exan^le 

Comments 

See Also 
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^ A ► Math: Round function 


Description 

Heading 

Syntax 

Inputs 

Returns 

Emits 

Errors 

Exanple 


Comments 


Rounds a floating-point value to the nearest integer value. 

Mathematics/Math 

Round(Val) 

Val An expression that evaluates to a floating-point value. 

An integer rounded ftom Val. 

Nothing. 

??None. 

• Round(l .4) returns 1 .00. 

• Round{1.5) returns 2.00 

• Round(1.6) returns 2.00. 

• RoundO returns the nearest integer. In contrast, CeilingQ truncates up to the next- 
larger integer; IntQ truncates down to the next-smaller integer, and TruncO 
truncates toward zero: 


Value 
1.2 
1.2 
3.6 
-3.6 


CeilingO 

2.00 
-2.00 
4.00 
-4.00 


Into 


1-00 
-2.00 
3.00 
-4.00 


RoundO 

LOO 
-1.00 
4.00 
-4.00 


TnincO 

1.00 
-LOO 
3.00 
-3.00 


See Also 


• In-Sight expresses integer values in floating-point format. For exan^le, the integer 
value 5 is displayed as 5.00. 

Abs, Calling. Exp, Jnt, Mod. Power, Rand. Sqrt. Sum, Tnmc, 


^ A ► Math: Rand function 


Description Returns a random number between 0.00 and 1 .00, updating it at a specified event. 

Heading Mathematics/Math 

Syntax Rand(Event) 

Inputs Event An event that forces an update. Must be a reference to a cell containing 

Acquirelmaize (the default). Button, or Event 

Returns A random number between 0.00 and 1 .00. 

Emits Nothing. 

Errors Event does not refer to a cell containing one of the listed functions. 

Example None. 
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Comments 


RandO niust reside by itself, in its own cell Other functions can refer to this cell to obtain 



the random value. 


/\Ds, nxp, ini, ivioa, j^ower, oqrt^ oiim. 

^ A ► 

Math: Row function 

Description 

Returns the row number of a referenced cell. 

Heading 

Mathematics/Lookup 

Syntax 

Row(Cell) 

Inputs 

Cell A reference to a worksheet cell. 

Returns 

The row number of Cell. 

Emits 

Nothing- 

Errors 

None. 

Example 

Row(B2) returns 2.00. 

Comments 

None. 

See Also 

Choose. Column, If, Maxl, Mini. 

^ A > Math: SDev function 


Description 
Heading 
Syntax 
Inputs 

Returns 

Emits 

Errors 

Exanple 

Comments 


See Also 


Returns the standard deviation from a variable number of values. 

Mathematics/Statistics 

SDev(Vall, Val2 .--) 

Vail ... A variable-length, comma-delimited list of values. Each value can be a cell 

reference, a cell range, or a floating-point value. 
The standard deviation value. 
Nothing. 

#ERR if all parameters are invalid 

SDev(0.5, 1. 2, 1 , 0.5) returns 0.61237, displayed as 0.612. 
SDevQ returns a value if at least one parameter is a valid numeric value. It ignores 
individual parameters that refer to empty cells or error cells and processes the valid 
parameters. For example, SDev(l, #ERR, 2, empty, 3) reUims 1.00, which is the 
standard deviation of 1, 2, and 3. If all parameters are invalid, SDevQ returns an error. 
Max. Mean. Min. 


^ A ► Math: Sin function 
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Description Returns the sine, given an angle in degrees. 

Heading Mathematics/Trigonometry 

Syntax Sin(Angle) . 

Inputs Angle An angle, in degrees. An expression that evaluates to a floating-point value. 

Returns The sine of Angle. 

Emits Nothing. 

Enors ??None. 

Example Sin(90) returns LOO. 

Commoits None. 

SeeAlso AjCos, ASin, AIM, Man2, 


^ A ► Math: Sqrt function 

Description Returns the square root, given a value. 

Heading Mathematics/Math 

Syntax Sqit(Val) . 

Inputs Val An expression that evaluates to a floating-point value. Must be non- 
negative. 

Returns Square root of Val. 

Emits Notiiing. 

Errors Val is negative. 

Exarr5>le Sqrt(9) returns 3 .00. 

Comments None. 

See Also Abs, Exg, Mod, Povi^er, Rand Sum. 


^ A ► Math: Sum function 


Description Returns the sum of a variable number of values. 
Heading Mathematics/Math 

Syntax Sum{Vall, Val2 ...) . , ^ . u 

Inputs Vail ... A variable-length, comma-delimited list of values. Each vahie can be a cell 

reference, a cell range, or a floating-point value. 
Returns The sum of Vail . . . ValN. 

Bnits Nothing. 

En-ojs . The sum exceeds ttie maximum representable value. ??WHAT IS THAT?? 

• All inputs are invalid. 

Example Sum(2, 2.1,3) returns 7.10. 
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Comments 


See Also 


SumO returns a value if at least one parameter is a valid numeric value. It ignores 
(interprets as zero) individual parameters that refer to empty cells or error cells and 
processes the valid parameters. For example, Sum(l, i^^ERR, 2, empty, 3) returns 6, 
which is the sum of 1 , 2, and 3. If all parameters are invalid, SumQ treats each a zero and 
returns 0.0. 

Abs. Exp. Jnt, Mod. Power. Rand Sqrt . 


^ A ► Math: Tan function 


Description Returns the tangent, given an angle in degrees. 

Heading Mathematics/Trigonometry 

Syntax Tan(Angle) 

Inputs Angle An expression that evaluates to a floating-point value. 

Returns The tangent of Angle. 

Emits Nothing. 

Errors ??None. 

Example Tan(45) returns 1 .00. 

Comments None. 

See Also A Cos. ASin. ATan. ATan2, Cos. Degrees. Pi, Radians. Sin . 


^ A ► Math: Trunc function 


Description Trxincates a floating-point value to an integer. 
Heading Mathematics/Math 
Syntax Trunc(Val) 

Inputs Val An expression that evaluates to a floating-point value. 

Returns An intereger truncated from Val. 

Emits Nothing. 
Errors ??None. 

Exanple • Trunc(5.995) returns 5.00 

• Trunc( 1 .6) returns 1 .00 

• Trunc(-i:2) returns -1.00 
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Comments 


TruncO truncates toward zero. In contrast, CeilingQ truncates up to the next-larger 
integer, IntQ truncates down to the next-smalier integer, and RoundQ returns the 
nearest integer: 


Value 
1.2 
1.2 
3,6 
-3.6 


CeilingO 

2.00 
-2.00 
4.00 
-4.00 


into 


LOO 
-2.00 
3.00 
-4.00 


RoundO 

1.00 
-1.00 
4.00 
-4.00 


TruncO 

1.00 
-1.00 
3.00 
-3.00 


• In-Sight ejqjresses integer values in fltiating-point format For exang)le, the integer 
value 5 is displayed as 5.00. 

See Also Abs. Ceiling, Exp, Int, Mod. Power. Rand Sqrt. Sum. Round . 
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< PatFind: Overview 

The PatFincTM functions perform patterrHmatching searches after building a model. The search supports two 
kinds of models, edge-based and area-based. An edge model extracts geometric boundaries from an image 
region and uses them to find instances of the model. Edge models tolerate variations in rotation, scale, and 
image intensity; they also tolerate partial occlusions. An area model extracts a specified image area to use as 
a template. It then measures the similarity between the template and an image region through normalized 
correlation, evaluating grayscale differences on a pixel-by-pixel basis. An area model tolerates variation in 
rotation and scale. Both kinds of model can be masked to exclude "don't care" regions fit)m consideration. 

This section introduces In-Sight's PatFind functions, discussing the following topics: 

• Getting Started with Pattern Matching 

• Building a Model 

o Choosing an Algorithm 
o Masking tlie Model 
o Setting the Offset Point 

• Searcliing an hnage 

o Setting Acceptance and Conftision Thiesholds 
o Setting the Number of Candidates to Find 
o Setting an Aiigle Range 
o Setting a Scale Range 

• Sorting the Results 

• PatFind Functions Reference . 

Vision applications use pattern matching for feature extraction, particularly for features that are stable in size 
and shape. The PatFind functions are under the Vision Processing heading. 


MA^ PatFind: Getting Started 

Pattern matching is a model-based search technique. It compares a model — an example of the desired 
feature — to regions of an image to find regions that fit the model In this topic, you extract a model from the 
image. Along the way, you learn some important In-Sight techniques. 

► To Extract a Modei of a Hole 

1 . Acquire an appropriate image. For this exercise: 

a. Open the part sample image , print it, and return to this topic. Place the printed image under the 
camera. 

b. Click and release A, select Live from the System menu, and click X to enter iive mode. 
Interactively adjust the image location, camera height, aperture, and focus until satisfied with the 
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image. 

c. Click A twice to exit live mode, acquire the last image, and return to the woricsheet 
To acquire a new image at any time, hold □ and click X 


2. Move to cell Al and click Xto open the Fomiula Builder . 

3. From the Vision Processing category, select PatFind, and then click X to open the FuidPattems 
propert^f^ sheet. 

4. To define the region of interest, select the Region heading and click X. In the resulting dialog box, 
click the Region button. hi-Sight hides the woricsheet and di^lays the Region cursor, which you 
interactively adjust with the Control Pad. Repeatedly clicking O cycles through the cursor modes. One 
mode sets the region's postion, another its size, and another its angle: 


Position 


Size 


Angle 


>247 - Col 


84 
-i- 


Row 


247- Wide 


High 



Degrees CCW 


5. Using the Control Pad cursor, set the ROI position by dragging the Region cursor imtil the center of 
the region is at the center of the hole. Next, click O to change the Region cursor to its resize mode. 
Resize the ROI to surround the hole, clicking Up and Down to set the height and Right and Left to set 
the width. Exclude the background, like this: 



6, Click OK. FindPattemsO extracts a model from the region and stores it in a Patterns stmcture . 



^ A ► PatFind: Building a Model 

In-Sight oifers two kinds of models, built by FindPattenis. Parameters related to the model region also offer 
a mechanism for interactively defining the ROI. For exanple, to define a model, you define an ROI 
containing an, example of it To set up the ROI containing the model: 

1 . In the FindPattemsO dialog, select the Region heading and click X. In-Sight opens the Graphics Edit 
Options dialog: 
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2. Select Region and click X. In-Sight hides the property sheet and replaces it with a rectangular cursor 
drawn on the image. 

3. Using the cursor, move the ROI rectangle up and down and right and left until its top-left comer is at 
the top-left comer of the ROI. 

4. To adjust the size, click the O, changing the cursor shape to a two-headed arrow, letting you resize 
the ROI horizontally or vertically. A model of a circular shape might look like this: 



5. When satisfied with the ROI, click X to accept it. In-Sight returns to the FindPattems() property 
sheet. 

NOTE Clicking the A button exits without changing the ROI. 

6. Set other model-related parameters such as the offset point 

7. Click Run to ??build the model without closing the property sheet??; click OK to build the model and 
close the property sheet. IivSight places a Pattems structure in the worksheet to store the model. 
Subsequent operations refer to this cell to obtain the model. 



^ A ► PatFind: Choosing the Algorithm 
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Discusses Non Linear. TTTmS TEXT GRABBED FROM ACUREAD. UNCERTAIN IF APPLICABI F 
IS NON LIN THERE THE SAME AS NON LIN HERE?? ^ ki AiiN APFUCABLE. 

A perfect OCR application would accurately read every sting every time. It would never reject even one 
character no matter how severely degraded or occluded, as unreadable. It would never mistake one 
character for another. 

A practical OCR appUcation cannot attain perfect success and perfect accuracy at the same time Real- 
world OCR is a trade-off between two conflicting goals: 

. Robustiiess— tiie percentage of reads reported as successful, also called read rate. High robustness 

typically improves throughput and reduces operator intervention. 
. Reliabilitj^flie percentage of reads that are actiially conect, also called accuracy. High reliability 

typically improves yields and reduces costs. 

Improving robustness by accqjting low-scoring characters can haim reliability. Improving reliability by 
rejecting low-sconng charactere can harm robustness. The right balance depends on your application Poor 
reliabiLty can be catastt^ophic, since misreads can cause production losses. Poor robustiiess is usually 
uiconvenient but not catastrophic. 

Most OCR methods lean one way or the other. A "restrictive" approach considere fewer character matches 
Its caution makes it less likely to misread but more likely to fail a readable stiing. An "inclusive" approach 
considers more matches. Its aggressiveness makes it more likely to read a degraded stiing but more likely to 
misread. Figure 53 contrasts the two approaches. 

Robustiiess and Reliability, in acuRead WILL ADAPT PICTURE 

Reflecting this distinction, acuRead offers two reading methods. Standard OCR and Non Linear OCRtm; 

. Standard OCR reads the string once using a resttictive OCR technique. Any character that scores 
above theStandard acceptance threshold "passes." Virtual Checksum is unavailable. Standard OCR 
IS the method used m early versions of the Cognex acuWin and WinOCR software. 

. Non Linear OCR reads the stiing twice, once with Standard OCR and again with Non Linear OCR. 
an inclusive technique. With Non Linear, acuRead (1) scores each character with both methods (2) 
applies the Standard acceptance direshold to the Standard scores and Non Linear threshold to tfie 
Non Linear scores, (3) selects the Non Linear or Standard result as described in How acuRead 
Woiks on page 779. You'll probably find Non Linear OCR better than Standard OCR for reading 
^wSiir^*^"^ occluded, or unevenly illuminated wafer scribes, especially if the stiing has a 

The reading method deteimines the algoritiim used to calculate the character and stiing scores. Non Linear 
CX:R is more permissive than Standard OCR, often reporting a character value where Standard OCR 
would report a? or * indicating "no match." Non Linear OCR also tends to report higher character and 
stimg scores This fact— its higher scores-has no significance by itself, because the Standard and Non 
Linear scores reflect different quantities. But because the scores do difTer. Standard and Non Linear OCR 
have distinct acceptance thresholds. 
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Non Linear OCR can often recognize characters that Standard OCR cannot read. It has more freedom to 
"guess" — and therefore more freedom to guess wrong. You can counterbalance this higher risk of felse 
matches by selecting a judicious Non Linear acceptance threshold In general, increasing an acceptance 
threshold increases your certainty that a character is correct when it passes, but also increases the chance of 
failing a readable character. 

The best counterbalance is the use of a SEMI, BC412, or IBM412 checksum If the string has a standard 
checksum, you can exploit the permissive aspect of Non Linear OCR while relying on the checksum to rule 
out false matches. Non Linear OCR is more likely than Standard OCR to return a coinplete string, but you 
can be confident of the result if the checksum passes. Combining Non Linear OCR with a standard 
checksum represents the best blend of robustness (read rate) versus reliability (accuracy). 

Lacking a checksum, you can still use Non Linear OCR, but you should specify high values for both 
acceptance thresholds to screen out high-scoring but incorrect characters. A better approach for reading 
scribes that lack a checksum is to use Virtual Checksum, as described in Enabling a Standard or Virtual 
Checksum on page 791. Figure 54 shows the benefits of the various approaches. 

Non Linear OCR with checksums 

Non Linear OCR is slightly slower than Standard OCR due to the second read operation. To keep this cost 
small, acuRead does not diplicate the string and character finding overhead. Many apphcations can ignore 
the small difference in speed in exchange for the benefit of using Non Linear OCR and Virtual Checksum. 
Non Linear OCR incorporates Standard OCR without replacing it, so you can view Non Linear OCR as an 
enhanced version of Standard OCR. 



^ A ► PatFind: Masking the Model 

??You can interactively define "don't care" regions though masking. This topic tells you how. 


To edit the , click XXXX, yielding the foUowing dialog: 
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=— — == — — — COGIMEX ln(Slghi; 

^ A ► PatFind: Setting the Offset Point 

?? You can interactively set the offset point This topic tells you how 

To edit the offset point or mask, click XXXX, yielding the following dialog: 



=_______== COGNEX Insight) 

^ A ► PatFind: Searching an Image 

After building a model, you can search an image for it Various parameters influence the search. Continuing 
the example, initiate the search as follows: 

1 . Open the FindPattems property sheet 

2. Using the cursor, select Model Data. Li-Sight defaults to interactive reference, hiding the property 
sheet. 

3. ?? Move to a Patterns structure, then click X to create the reference — which is, by default, absolute. 

4. Click Region to define the ROl for the search. By default, In-Sigjit sets the ROI interactively. Use 
the Control Pad cursor, X and A buttons to surround the area of the image you wish to search: 
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5. Edit the search parameters. For example, increase the Number to Find from 1 to 4. 

6. Click Run. In-Sight searches the image, drawing a cross mark at the center of each instance found: 



7. 

8- Click OK, closing the property sheet. FindPattemsQ emits result cells, from which other fonnulas can 
obtain specific result values: 

Objects storing results 


Emitted results 
for matched instances 

ffBRR results 
(N2Fmd > actual number) 

FindPattemsO also generates a Patterns structure containing the data about the matched instances. 



^ A ► PatFind: Accept and Confus Thresholds 

?? topic to discuss acceptance thresholds 

Yes 
Mayt>e 
No 

RAW TEXT, as a starting point 
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AcuSymbol searches for the symbol in the image to find the area of the image most similar to the symbol 
model- To measure the similarity, it calculates a correlation score between the image area and the model. A 
score of 0 indicates "no correlation," and a score of 100 indicates "perfect correlation." Increasing similarity 
between tfie model and area yields a higher score. 

The acceptance and confusion thresholds are score values that control whether an image area matches or 
fails to match the model. The acceptance threshold defines the lowest score for a valid match. Image areas 
with scores below the acceptance value are not matches, so AcuSymbol immediately rejects them as 
potCTitial symbol locations. The confusion threshold similarly defines the highest score for an invalid match. 
Areas with scores above the confiision value are matches, and AcuSymbol immediately accepts them as 
potential symbol locations. As shown in Figure 62, scores between the two thresholds might or might not 
match the nxKlel. 

The search stops when the number of matches reaches N2Eval. If no match exceeds the acceptance 
threshold, then AcuSymbol zeros all Pose result values. 

The valid range for both thresholds is 20 to 99, where 20 is a permissive standard and 99 is a strict 
standard. The default confusion yalue is 70, and the default acceptance value is 30. The defaults are 
appropriate for most applications and rarely require adjustment. If you do change the values, always set the 
confusion value above the acceptance value. 

The major basis of choice for both thresholds is image quality, symbol quality, and the amount of separation 
between the symbol and its background. If your images contain ^)eckle or other noise that might be 
mistaken for a symbol during the search phase, then increasing the thresholds can improve robustness (the 
percentage of decodes reported as successfiil) by decreasing the risk of false matches (which would all fail in 
the subsequent decode phase). But setting the thresholds too high can also harm robustness because it 
increases the risk of failing to find a decodable symbol. Low thresholds are often safe because the ECC 
checks during decoding are very reliable — a decode either works or fails outright, regardless of image or 
symbol quality. 

For example, consider the pathological situation where a symbol is printed on a checkered background. 
Here, any random image area will exhibit some correlation to the model If the thresholds are too low, then 
the search cannot distinguish the symbol fiom its background. If they are too high— forcing matches to have 
near-perfect correlations — ^then the search can miss genuine symbols due to minor misconrelations- 



^ A ► PatFind: Setting the Number to Find 

?? topic to discuss n2find 

During the search phase, ?? keeps track of the number of matches greater than or equal to the confusion 
threshold. Generating a large pool of candidates increases the likelihood of finding a good candidate, but 
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generating an excessive number of candidates wastes time. You can limit the potential duration of the search 
by setting a maximum number of candidate responses (N2Eval). 

A search operation stops when it the number of candidates reaches N2Eval. To reach N2Eval, al! 
candidates must be less than the confusion threshold, so the find operation selects the best candidate 
between the acceptance and confusion thresholds. If none, it returns 0 (failure) and sets all Pose values to 0. 

The default N2EvaI value is suitable for many apjplications, but reducing N2Eval can slightly reduce search 
time. 


^ A ► PatFind: Setting an Angle Range 

How to define an angle range RAW TEXT, as a starting point 


To compensate for differences in orientation between the model and the image, ?? can apply an angle to the 
model before applying it to the image. 



Model Rfvtsted Model 


The angular rotation can any positive or negative value up to 180 degrees — sufficient to completely rotate 
the model with respect to the image. 

AcuSymbol applies the angle and subsequently uses the angled model, so this operation has a minor, one- 
time computational cost. Nonetheless, you should if possible build a model that agrees with the expected 
image orientation, eliminating the need to rotate the model. 

?? can also sweq> the model through a range of angles: 



Rotated Model Rotated Model 
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Starting at the cunent angle, it applies a specified rotational variance, in ± degrees, tolerated during a search 
The valid range is 0 to 1 80 degrees— enough to sweep the model through all possible angles. 

Searching an angle range can inprove robustness if you cannot maintain a fixed symbol angle in the image 
For example, consider a manufacturing process that exhibits some angular jitter. Here, specifying an angle 
range would let the decoder find the symbols de^ite the inconsistency. In general, increasing the range 
increases the search space, reducing speed For best results, minimize rotational tolerance as much as 
possible, 

TRANSLATE THIS TEXT TO FIXTURE A strategy for gaining the benefit of searching an angle range 
without excessive conputational cost is to combine it with centering, which adjusts the angle to that of the 
last symbol successfiilly found For details, see Centering the Symbol on page 932. 

A side effect of applying an angle to the model is the need to increase the size of the region of interest The 
exact increase depends on the angle, with the worst case governed by the diagonal: 


Model rotated IT 

(best case) 


Model rotated 45^ 

(worst case) 



•^wctth —> 

Mnimuin height 
and width =x 



width ^ 

Mnnaum height 
and width =x*v5" 


In gmeral, the region of interest must contain the entire symbol— plus a three-module space on all sides for 
the quiet zone, plus an adequate positional tolerance, plus a margin sufficient for rotating or rescalinc the 
model. 


^ A 


► PatFind: Setting a Scale Range 


How to define a scale range. RAW TEXT, as a starting point. 

To compensate for differences in size between the model and the image, ??0 can apply a scaling factor to 
the model before applying it to the image. The scale can vary from 80 to 1 50 percent, where the original 
model IS 100 percent. This following figure shows the result of the size compensatioa 

Scale = 80% Model = 100% Scale = 120% 
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AcuSymbol applies the scaling once and then uses the scaled nncxlel. Rescaling incurs a one-time cost, but 
building the model at the expected size eliminates the adjustment 

As with the angle range operation, AcuSymbol can sweep the model through a scale range. It starts at the 
current scale and applies a specified variance, in ± percent, tolerated during a search. The maximum 
tolerance is 20%. 



Searching a scale range can improve robustness if the symbol image varies in size, since the decoder can find 
the symbols despite the inconsistency. Increasing the range increases the search space, reducing speed, 
accuracy, and reliability. For best results, minimize the scale tolerance as much as possible. 

A side effect that applies to the Angle Range also applies to scaling. The minimum size of the region of 
interest depends on the effective size of the model When setting the region, include a margin adequate for 
the upper end of the scale range — including about three modules on all sides for the quiet zone. 


Model rotated If Model rotated 45*" 

(bestcase) (worstcase) 



Mn rni urn height Mh in uro height 

and width :=x and width = x 



^ A ► PatFind: Sorting Results 

Discusses Sorting. D*oh! 
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^ A ► PatFind: Functions Reference 

FindPattems Extracts an area or edge model from a region; or searches for instances of a specified model; 

or extracts and searches in one step. 
Patterns Stores an area or edge model and the resiilts of a pattern-match search. Each matched 
structure instance found has a zero-based index and a set of measured values Coordinates in Image 

units (pixels) unless converted by TransPattemsToWorldQ. 
SortPanems Sorts a Patterns structure by specified criteria. Stores a new, sorted Patterns structure. 

TransPattemsToWorld, under Coordinate Transforms, converts a Patterns structure to World coordinates. 
Results functions, under Data Access, that get values fi-om a Patterns structure are GctAngle. GetCo!. 
GetNFoiuid. GetRow, GetScale, and GetScore . 


^ A ► PatFind: FindPatterns function 


Description 


Heading 

Syntax 

Inputs 


Extracts an area or edge model from a region; or searches for instances of a specified 
model; or extracts and searchs in one step. Reports matches sorted by score. Stores the 
matched instances in a Patterns structure. 
Vision Processing/PatFind 

FindPattems(Image, Patterns, Fixture, Model Region, . . . Show) 


Image 
Patterns 

Fijrture 
— Row 
— Column 
— ^Theta 

Model Region 

—X 

—V 

—High 

— Wde 

— ^Angle 

Offset 

Mode 

Coarseness 
Accuracy 
ForceTrain 
Find Region 


Image data source, a reference to an Image structure . Defeult is $ A$0. 
To build a new model, set to 0 (the default). To use an existing model, 
set to reference to a Patterns structure . 

Fixture origin, defined by row, column, and angle offsets, typically to 
compensate for image-to-image variation in position, orientation, or 
both. Row and Column are offsets, in pixels firom the image origin, 
Theta is a rotation from the image row axis, ± 360° CCW. Defaults aU 
0 (the image origin). See IVorkins with Fixtures . 
Region used as a model. X and Y define the top-left point by offsets 
from the Fixture origin, in pixels. High and Wide are the height and 
width, in pixels. Angle is a rotation from the Fixture X axis, 
± 360° CCW. See Defhiin^ a Renion of Interest , 


Reference point, an offset from the model center. 

Template matching algorithm to use. One of area model, edge model, or 

edge max. 

Distance between edges in the model: fine, medium, or coarse. 
Tradeoff between accuracy and speed: accurate, medium, or fast. 
ON always trains; OFF trains only if the model has changed 
Region searched for the model. X and Y define the top-left point by 
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Stores 
Emits 


Errors 
Comments 
See Also 


—X 
— Y 
—High 
—Wide 
— ^Angle 
Number to 
Find 
Angle 
Range 

Scale Tolerance 


oflfeets fiom the Fixture origin, in pixels. High and Wide are the height 
and width, in pixels. Angle is a rotation from the Fixture X axis, 
± 360° CCW. See Defining a Reeion of Interest . 


Number of candidates sought. See Setting tlie Niunber to Find. 


Angle range to search. Valid range, ± 360** CCW from the model. See 
Setting an Angle Ranae . 

ON enables a scale tolerance during a search. See Setting a Scale 
Range 

Accept Thresh Acceptance threshold, the lowest acceptable score, 1 to 100. See 

Setting Accept and Con fits Thresholds . 
Confus Thresh Confusion threshold, the highest score for an invalid instance, 1 to 100. 
Show Selects the graphics to display, as described in Flyover Graphics : 

• HideaD 

• Result gr^hics only 

• Input and resuh graphics 

• Show all, which displays input, result, and chart (if any) graphics. 

Patterns On success, a Patterns structure, which stores the matched instances. 

Index Zero-based index of a matched instance. 

NFound Number of matched instances. Read by GetN Found . 

Row Center row of instance, ??in what coordinate system? Read by GetRow . 

Col Center column of instance. Read by GetCol . 

Angle Angle of instance, in counterclockwise degrees relative to the model. Read 

by GetAngle . 

Scale Scale of the instance, as a percentage of model. Read by GetScale . 

Score Score of the instance. Read by GetScore . 

Invalid parameter. 
None. 

TransPattemsTo World 


^ A ► PatFind: Patterns structure 

Description Stores an area or edge model and the results of a pattern-match search. Each matched 

instance has a zero-based index and a set of measured values. Coordinates in Image units 
(pixels) unless converted by TransPattemsToWorld . 
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Values 


Value 


Index 


Angle 


Column 


NFound 


Row 


Scale 


Score 


Description 


Access function 


Comments 
See Also 


Index identifiying a particular matched instance. — 

Zero-based, so the first instance is indexed 0.00, 

the second is indexed 1 .00, and so on. 

Angle of instance relative to the model. In CCW GetAngle 

degrees from the Image Row axis unless converted 

to World coordinates by TransPattemsToWorldQ- 

Center point, column value. In pixels unless GetCol 

converted by TransPattemsToWorldO- 

Number of instances stored in the Patterns GetNFound 
structure. Not converted by 
TransPattemsToWorldO because it is not a 
coordinate. 

Center point, row value. In image units unless GetRow 

converted by TransPattemsToWorldQ. 

Scale, as a percentage of the model. Not GetScale 

converted by TransPattemsToWorldO because it 

is not a coordinate. 

XXXXx. 0.00 to 100.00. Not converted by GetScore 

TransPattemsToWorldO because it is not a 

coordinate. 


None. 

TransPattemsTo World 


< PatFind: SortPatterns function 

Description Sorts a Patterns structure by specified criteria. Stores a new, sorted Patterns structure. 
Heading Vision Processing/PatFind 

Syntax SortPattems(Pattems, Sort By, Number to Sort, Reference, Show) 

Inputs Patterns Search results. A reference to a Patterns structure, from FindPattems . ?? 

Why is this the value 1 in the interface?? 
Sort By Criterion for sorting the FindPattemsO results. One of: 


Number 
to Sort 


• score 

• row 

• column 

• angle 

• scale 

• distance, from the reference point 

• grid (rows, then cols, fix>m the reference point. 

Number of search results to sort. 

Tk^-f ^ -.J ^..1 iX-__*_ .C 
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Stores 
Emits 


ivcierciicc 
—Row 
— Column 
— Angle 
Show 


fvciciciicc po lit, tvuw aiiu v^oiUiiiii aic uii:»ci:> uuui uic iiiagc ui g ii, n 
pixels. Angle is a rotation from the image row axis, 0 through 360 degrees 

ccw. 

Selects the graphics to display, as described in Flvover Graphics : 

• Hideall 

• Result gr^hics only 

• Input and result graphics 

• Show all, which di^lays input, result, and chart (if any) graphics. 


Patterns 


On success, a Patterns structure, which stores the sorted pattern-match 
results. 

Index Zero-based index of a matched instance. 

NFound Number of matched instances. Read by GctN Found . 
Row Center row of instance, ??what coordinate system? Read by GetRow . 

Col Center column of instance. Read by GetCol . 

Angle Angle of instance, in counterclockwise degrees relative to the model. Read 

by GetAngle. 

Scale Scale of the instance, as a percentage of model. Read by GetScale. 

Score Score of the instance. Read by GetScore . 

Ennors Invalid parameter. 

Comments None. 

See Also Sorting Pattern Match Results, FindPattems. TransPattemsToWorld 
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^ A ► Structures: Overview 

The Structures ftinctions provide a contact way to store a circle, cross, fixture, line, point, or region. Each 
function creates an structure that stores a set of values. For example, the CircleQ function creates a Circle 
structure that stores the circle's center row, center column, and radius values. All of the values that define the 
circle then reside in a single cell, instead of consuming one cell each, simplifying the worksheet 

This section introduces the Structures ftinctions and structures, discussing the following topics: 


• Getting Started with the Structures Functions 

• Structures Functions Reference . 


A usefiil technique based on the Structures fimctions is to define structures for "global" items. Changing a 
value in the structure changes it in ail formulas that refer to it, improving clarity and convenience. For 
example, suppose you want to apply more than one feature extraction fimction in the same region of interest. 
Creating a Region stnicture through the Region fimction makes it easy to define the region parameters and 
share them in all ^plicable contexts. 

NOTE To access the Structures fimctions from the Formida Builder, open the Advanced heading. 


^ A ► Structures: Getting Started 

In this topic, you create a Region stnicture with the Region function . You then use it to control the region for 
two other ftinctions. Finally, you use the Control Pad to redefine the region, showing how both referencing 
ftinctions share the same region. The result looks like this: 

Region object 
(stores region) 


Hist object 
(stores histogram) 


Blobs object (± 
(stores blob features) 



The techniques shown h^e apply equally well to all Stmctures fimctions. 
► To Share a Region 
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1 . Acquire an appropriate image. For this exercise: 

a. Open the part sample image, print it, and return to this topic. Place the printed image under the 
camera. 

b. Click and release select Live from the System menu, and click X to enter live mode. 
Interactively adjust the image location, camera height, aperture, and focus until satisfied with the 
image. 

c. Click A twice to exit live mode, acquire the last image, and return to the woiksheet 
To acquire a new image at any time, hold □ and click X. 

2. Leaving cell Al empty, move to cell A2, click Xto open the Formula Builder. 

NOTE Try to leave a blank row above fiinctions that emit fomiulas. In-Sight prints descriptive labels 
above emitted formulas if it has room for the labels. If the row above is occupied, it emits 
only the numeric values, without labels. 

3. Open the Advanced heading, select the Region function from Structures, and clickX . 

4. On the RegionQ property sheet, interactively define the region parameters by clicking the Region 
heading. In-Sight hides the woricsheet and displays the Region cursor, which you adjust with the 
Control Pad. Outline an area containing a hole or other feature, click X to accept, and then click OK 
to close the property sheet. The Region fiinction returns a Region structure and emits the region 
parameters: 


Region object 
stores region- 
parameters 


Flyover graphic^ 
shows region 



Emitted region 
values 


5 . Extract a histogram from the region: 

a. From cell A4, click Xto open the Formula Builder. From Vision Processing, open the 
Histogram heading, select the ExtractHistogram fimction, and clickX to open its property 
sheet. 

b. Click and hold X on ExtractHistograrnQ's Region heading, yielding the Enter menu. Cursor 
Up to Relative, and then release X 

c. Move the marquee to B2 (the Row value), click and hold O, and click cursor Right to select 

the range B2: BF (you can ignore BG, the Curve value). Release O, and then clickX to accept - 
the references and return to the ExtractHistogramQ property sheet. 

NOTE To create references to the region, you must refer to the emitted row, column, and 
radius values. You cannot refer directly to the Region structure. 

d. Click OK. ExtractHistogramO returns a Hist structure and emits several statistical values. 

6. Extract a blob from the same region: 

a. From A6, open the Formula Builder. Under Vision Processing, open the Blob heading, select 
ExtractBlobs. and clickX to open its property sheet. 

b. As before, click and hold X on the Region heading, opening the Enter menu. Select Relative 
and release X. 

c- Move the marquee to B2, click and hold O, and click cursor Right to select the range B2:BF 
(the emitted region values). Release O, and then click X to accept the references and return to 
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the property sheet. 

d. Click OK to close the property sheet. ExtractBlobsQ returns a Blobs structure and emits 
values describing a blob. 

Change the region, to show how ExtractHistogramO and ExtractBlobsQ share the same parameters: 

a. Move to cell A2, which stores die Region structure, and click X to open the Region© property 
sheet. 

b. Click RegionQ's Region heading. As before, In-Sight displays the Region cursor. 

c. Adjust the region with the Control Pad. Outline an area containing a different feature, click X to 
accept, and then click OK to close the property sheet ExtractHistogramO and ExtractBlobsO 
update their values to reflect the new region of interest: 


Region object 
(stores region) 


Hist object 
(stores histogram) 


Blobs object d: 
(stores blob features) 



< Structures: Function Reference 


Circle fimction 
Circle structure 
Cross function 
Cross shructiire 
Fixture function 
Fixture structure 
Line function 
Line structure 
Point fxmction 
Point structiu'e 
Region flinction 
Region stiiicture 


Creates a Circle structure- 
Stores a fixtured circle. 
Creates Cross structure. 
Stores a fixtured cross-mark. 
Creates a Fixture structure. 
Stores fixture coordinates. 
Creates a Line structure. 
Stores a fixtured line. 
Creates a Point structure. 
Stores a fixtured point. 
Creates a Region structure. 
Stores a fiixtured region. 


Oata Access functions that get individual values from the Circle, Cross, Fixture, Line, Point, and Region 
structures are GetAnglc. GetCoK GetCurv^e, GetFligh. GetRadius. GetRow, and GetWide . 


IniSight) 
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^ A ► Structures: Circle function 


Description 
Heading 
Syntax 
Inputs 


Stores 
Emits 


En-ors 
Comments 


See Also 


Creates a Circle structme . 
Advanced/Structures 
CircIe(Fixture, Circle, Show) 


Fixture 
— Row 
— Column 
— Theta 

Circle 
— Row 
— Column 
— Radius 
Show 


Fixture origin, defined by row, column, and angle offsets, typically to 
compensate for image-to-image variation in position, orientation, or both. 
Row and Column are offsets, in pixels from the image origia Theta is a 
rotation fiiom the image row axis, ± 360** CCW. Defaults all 0 (the image 
origin). See Workiim with Fixtures . 

A circle, defined by its center point and radius. In Pixel or World units. 


Selects the graphics to display, as described in Fhover Graphics : 

• HideaU. 

• Result graphics only. Does nothing for CircleQ, which has no result 
graphics. 

• Ii^ut and result graphics. 

• Show all, which displays input, result, and chart (if any) graphics. 

Circle On success, a Circle stmcture. which stores the circle- 

Row Center row. Read by GetRow . 

Col Center column. Read by GetCol . 

Radius Radius. Read by GetRadius . 

Invalid parameter. 

One use is to define a circle in one place for multiple functions that refer to the same circle. 
Another use is to create a fixtured circle for functions that have circle parameters but not 
fixture parameters (PlotCircle. for example). 

Circle structure . Cross flinction. FixUire function . Line function. Point function. Region 
fluiction. 


^ A ► Structures: Circle structure 

Description Stores a fixtured circle. 

Values Value Description Access function 

Row Center row coordinate. In Pixel or Worid units. GetRow 

C<dumn Center colunm coordinate. In Pixel or World units. GetCol 

Radius Radius. In Pixel or Worid units. GetRadius 
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Comments Created automatically by functions that store circle parameters or manually by the Circle 
function . The stored values are in Pixel or World units, reflecting the fiinction that created 
this structure. 


See Also 


NOTE To create references to the circle, you must refer to the emitted row, column, and 
radius values. You cannot refer directly to the Circle structure to obtain its stored 
values. 

Circle flinction. 


^ A ► Structures: Cross function 


Etescription 
Heading 
Syntax 
hiputs 


Creates a Cross structure . 
Advanced/Structures 
Cross(Fixture, Cross, Show) 


Stores 
Emits 


Errors 
Comments 


Fixture 
— Row 
— Column 
— Theta 

Cross 

—X 

— Y 

— Angle 

—High 

—Wide 

Show 


Fixture origin, defined by row, column, and angle offsets, typically to 
conq>ensate for image-to-image variation in position, orientation, or both. 
Row and Column are offsets, in pixels from the image origin. Theta is a 
rotation from the image row axis, ± 360° CCW. Defaults all 0 (the image 
origin). See Working with Fixtures , 

A cross mark. X and Y define the center point by offsets from the Fixture 
origin, in pixels. Angle is a rotation of the cross mark from the Fixture X 
axis, ± 360° CCW. High and Wide are the height and width, in pixels. 


Selects the graphics to display, as described in Flyover Graphics '. 

• Hide all. 

• Result graphics only. Does nothing for CrossQ, which has no result 
graphics. 

• Input and result graphics. 

• Show all, v^ch displays input, result, and chart (if any) graphics. 


Cross On success, a Cross stnicturc, which stores the cross mark. 

Row Center row. Read by GetRow . 

Col Center column. Read by GetCol . 

Angle Angle, in counterclockwise degrees. Read by GetAngle . 

High Height, in pixels. Read by GetHigh . 

Wide Width, in pixels. Read by GetWide . 

Invalid parameter. 

One use is to define a cross mark in one place for functions that refer to the same cross 
mark- Another use is to create a fixtured cross mark for functions that have cross marie 
parameters but not fixture parameters (PlotCross. for example). 
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See Also Cross structure. Circle function. Fixture fimction. Line flmction. Point function. Region 

function. 


^ A ► Structures: Cross structure 


Description Stores a fixtured cross mark. 
Values Value 


Description 

Row Row coordinate. In Pixel or World units- 

Column Column coordinate. In Pixel or World units. 

Angle Angle. In Pixel or World units. 

High Height. In Pixel or World units. 

Wide Width. In Pixel or World units. 

Comments Created automatically by functions that store a cross mark or manually by the Cross 

fiuKtion . The stored values are in Pixel or World units, reflecting the function that created 
this structure. 


Access function 

GetRow 

GetCol 

GetAngle 

GetHigh 

GetWide 


See Also 


iNOTE To create references to the cross mark, you must refer to the emitted values. You 

cannot refer directly to the Cross structure. 
Cross fluiction. 


A ► Structures: Fixture function 


Description 
Heading 
Syntax 
Inputs 


Creates a Fixture structure . 
Advanced/Stmctures 
Fixture(Fixture, Show) 

Fixture Fixture origin, defined by row, column, and angle offsets, typically to 

— Row compensate for image-to-image variation in position, orientation, or both. 
— Column Row and Column are offsets, in pixels from the image origiiL Theta is a 
— Theta rotation from the image row axis, ± 360° CCW. Defaults all 0 (the image 

origin). See Working with Fixtures , 
Show Selects the graphics to display, as described in Flyover Graphics : 

• Hide all. 

• Result graphics only. Does nothing for FixtureQ, which has no result 
graphics. 

• Input and result graphics. For Fixture(), shows the input point 

• Show all, which displays input, result, and chart (if any) graphics. 


Stores 


Fixture 


On success, a Fixture structure, which stores the fixture. 
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Emits Row Row value of fixture origin. 

Col Column value of fixture origin 

Theta Angle of fixture, in counterclockwise degrees fiDm the image column 

axis. ??CurTently Angle in interface. Is this changable?? 
Enors Invalid parameter- 

Comments None, 

See Also Circle fiinction> Cross fimction. Fixture stincture. Line fimction. Point fiinction. Region 

fiinction. 


A ► Structures: Fixture structure 

Description Stores fixture coordinates. 

Values Value Description Access function 

Row Row coordinate. An offset, in pixels fiDm the image GetRow 

origin. 

Column Column oordinate. An offset, in pixels fiom the GetCol 

image origin. 

Angle Angle (theta). A rotation fmm the image row axis, + GetAn&le 

or - 360 degrees counterclockwise. 
Comments Created by the Fixture fiinction . 

See Also Fixture fimctio!!. 


^ A ► Structures: Line function 


Description 
Heading 
Syntax 
Inputs 


Creates a Line structure . 
Advanced/Structures 
Line(Fixture, Line, Show) 


Fixture 
— Row 
— Column 
—Theta 

Line 
— RowO 
— ColumnO 
— Rowl 
— Coliunnl 
Show 


Fixture origin, defined by row, column, and angle oflfeets, typically to 
compensate for image-to-image variaticMi in position, orientation, or both. 
Row and Column are offsets, in pixels fix>m the image origin. Theta is a 
rotation fix)m the image row axis, ± 360^ CCW. Defaults all 0 (the image 
origin). See Workine with Fixtures . 

A line. Row 0 and Column 0 are the first end point, and Row 1 and 
Column 1 are the second end point. In Pixel or World units. 


Selects the graphics to display, as described in FIvover Graphics : 
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• Result graphics only. Does nothing for LincQ, which has no result 
graphics. 

• Input and result graphics. For LineQ, shows the input line. 

• Show all, A\1iich displays input, result, and chart (if any) graphics. 

Stores line On success, a Line stnicture. which stores the line. 

Emits RowO First end point, row coordinate. Read by GetRow . 

CoIO First end point, column coordinate. Read by GetCoi . 

Rowl Second end point, row coordi oate. Read by GetRow . 

Coll Second end point, column co< )rdinate. Read by GetCoL 

Errors Invalid parameter. 

Comments One use is to define a line in one place for multiple functions that refer to the same line. 

Another use is to create a fixtured line for functions that have line parameters but not 

fixture parameters (PlotLine. for example). 
See Also Ciicle function. Cross fiinction. Fixture function. Line strucuire. Point function. Region 

function . 


^ A ► Structures: Line structure 


Description Stores a fixtured line. 

Values Value Description Access function 

RowO First end point, row coordinate. In Pixel or World GetRow. index 0 

units. 

ColO First end point, column coordinate. In Pixel or GetCol. index 0 

World units. 

Rowl Second end point, row coordinate. In Pixel or GetRow. index 1 

Worid units. 

Coll Second aid point, column coordinate. In Pixel or GetCol. index 1 

World units. 

Comments Created automatically by functions that store a line or manually by the Line flmction . The 

stored values are in Pixel or World units, reflecting the fimction that created this structure. 


NOTE To create references to the line, you must refer to the emitted row and column 
values. You carmot refer directly to the Line structure. 
See Also Line fiinction . 



^ A ► Structures: Point function 
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Description 
Heading 
Syntax 
Inputs 


Stores 
Emits 

Errors 
Comments 


See Also 


Creates a Point structure ^ 
Advanced/Structures 
Point(Fixture, Point, Show) 


Fixture 
— Row 
— Column 
— Theta 

Point 
— Row 
— Column 
Show 


Fixture origin, defined by row, column, and angle offsets, typically to 
compensate for image-to-image variation in position, orientation, or both. 
Row and Column are offsets, in pixels from the image origin. Theta is a 
rotation from the image row axis, ± 360** CCW. Defaults all 0 (the image 
origin). See Working with Fixtures , 
A point. In Pixel or World units. 


Selects the graphics to display, as described in Flyover Graphics : 
0 Hide all. 

• Result graphics only. Does nothing for PointQ, which has no result 
graphics. 

• Iiput and result graphics. For PointQ, shows the input point 

• Show all, which displays input, result, and chart (if any) graphics. 


Point On success, a Point structure which stores the point 

Row X or Row value. Read by GetRow . 

Col Y or Col value. Read by GetCol . 

Invalid parameter. 

One use is to define a point in one place for multiple fimctions that refer to the same point 
Another use is to create a fixtured point for functions that have point parameters but not 
fixture parameters (PlotPoint for exan^le). 

Circle function. Cross function. Fixture function. Line function. Point structure. Region 
function. 


A ► Structures: Point structure 


Description 
Values 


Comments 


Stores fixtured point. 

Value Description Access function 

Row Row coordinate. In Pixel or World units. GetRow 

Column Column coordinate. In Pixel or World units. GctCol 

Created automatically by fimctions that store a point or manually by the Point function . 
The stored values are in Pixel or World units, reflecting the fiinction that created this 
structure. 


See Also 


NOTE To create references to the [x>int, you must refer to the emitted row and column 

values. You cannot refer directly to the Point structure. 
Point function. 
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^ A ► Structures: Region function 


Description 
Heading 
Syntax 
Inputs 


Stores 
Emits 


Errors 
Comments 


See Also 


Creates a Region striicnire . 
Advanced/Structures 
Region(Fixture, Region, Show) 

Fixture Fixture origin, defined by row, column, and angle offsets, typically to 
— Row compensate for image-to-image variation in position, orientation, or both. 
— Column Row and Column are offsets, in pixels from the image origin. Theta is a 
— ^Theta rotation from the image row axis, ± 360° CCW. Defaults all 0 (the image 

origin). See Working with Fixtures , 
Region A rectangular or curved region. X and Y define the top-Iefl point by offsets 
— X from the Fixture origin, in pixels. High and Wide are the height and width, 

— Y in pixels. Angle is a rotation from the Fixture X axis, ± 360° CCW. Curve 

— High is the angle of curvature, ± 360° CCW. (For curved regions, Wde is the 
— ^Wide arc distance at the center of the region.) See Defining a Resion of 
— ^Angle Interest . 
— Curve 

Show Selects the graphics to display, as described in FIvover Graphics : 

• Hide all. 

• Result graphics only. Does nothing for RegionO, which has no result 
graphics. 

• Ir^ut and result graphics. 

• Show all, which displays input, result, and chart (if any) graphics. 

Region On success, a Region structure, which stores the region coordinates. 
Row Row value of region origin. Read by GetRow . 

Col Column value of region origin. Read by GetCol . 

High Height, in pixels. Read by CetHigh. 

Wide Width, in pixels. Read by Get Wide . 

Angle Angle, in counterclockwise degrees, of the region. Read by GctAngle . 

Curve The angle of curvature, in counterclockwise degrees. Read by GetCurve . 

Invalid parameter. 

One use is to define a region in one place for multiple functions that refer to the same 
region. Another use is to create a fixtured region for functions that have region parameters 
but not fixture parameters fPlotRegion. for example). 
Region stiiicture. Getting^ Started with the Structures Functions. 
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^ A ► Structures: Region structure 


Description 
Values 


Stores a fixtured region. 

Value Description 
Row Row coordinate. An offset fiom the Fixture origin, 

in pixels. 

Cohimn Colunrm coordinate. An offset from the Fixture 

origin, in pixels. 

Angle Angle. A rotation from the Fixture X axis, + or - 

360 degrees counterclockwise. 
High Hei^t In pixels. 

Wide Width. In pixels. 

Curve Angle of curvature, in counterclockwise degrees. 


Access function 
GetRow 

GetCol 

GetAnele 

GetHigh 
GetWide 
GetCurve 


Comments Created autcHnatically by fiinctions that store a region or manually by the Region function . 

NOTE To create references to the region, you must refer to the emitted row, col, high, 

wide, angle, and curve values. You cannot refer directly to the Region structure to 
obtain its stored values. 
See Also Region flmction. Geftin^ Sfarteci with the Structures Functions. 
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^ A ► System Functions: Introduction 

The System fimcticms let you hi^-level operations firom within the worksheet For example, you can save a 
job or load one. This section discusses the following topics: 

• System Functions Reference 


The Systems functions are under Advanced. 


^ A ► System Functions: Reference 

EnterLive Puts In-Sight in live mode or graphics mode. 

LoadJob Loads a specified job at a specified event. 

Save Job Saves a specified job at a specified event 

SetOnlinc Puts In-Sigjit in online mode or offline mode. 


^ A ► System Functions: EnterLiveQ 


Description 
Heading 
Syntax 
Inputs 

Returns 
Emits 
Errors 
Comments 
See Also 


Puts In-Sight in live mode. 

Advanced/System 

EnterLive(Evait) 


Event 


Nothing. 
None. 

???? 
None. 


An event that triggers EnterLiveQ- Must be a reference to a cell containing 
AcQidtelmage (the default), Button, or Evmt. 

77? 


► System Functions: LoadJobQ 
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Description 
Heading 
Syntax 
Inputs 


Returns 
Emits 
Enors 
Conrunents 
See Also 


Loads a specified job at a specified event. 

Advanced/System 

LoadJob(Event, JobID) 

Event An event triggers LoadJobQ- Must be a reference to a cell containing 

Acquirelmage (the default). Button, or Event 
Jobm Job ID. 0 through 19. 

??? ???. 
Nothing. 
None. 
???? 
SaveJob 


^ A ► System Functions: SaveJobQ 


Description 
Heading 
Syntax 
Inputs 


Returns 
Emits 
Errors 
Comments 
See Also 


Saves a specified job at a specified event. 

Advanced/System. 

SaveJob(Event, JobID, Name) 


Event 

JobID 
Name 

??? 

Nothing. 
None. 

???? 
LoadJob 


An event that triggers SaveJobQ. Must be a reference to a cell containing 
Acquirelmage (the default). Button, or Event 
Job ID. 0 through 19. 

A name for the job. A text string up to 15 characters long. 


A ► System Functions: SetOnlineQ 


Description 
Heading 
Syntax 
Inputs 


Returns 

Emits 

Errors 


Puts In-Sight in online mode or offline mode. 

Advanced/System 

SetOnline(Event, Mode) 


Event 

Mode 

??? 

Nothing. 
None. 


An event that triggers SaveJobO- Must be a reference to a cell containing 
Acquirelmage (the default). Button, or Event 
1 for online, 0 for offline. 

??7 
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3. 
4. 


Using the Control Pad cursor, move to any cell in the row or column to be selected- 
Holding down the O button, click cursor Left to select a row or cursor Up to select a column. 
In-Sight highlights the selected row or column: 


Selected row 


Selected column 



Release O. In-Sight opens the Edit menu. 

From the Edit menu, select a command and click X. 


^ A ► Worksheet: Cut, Copy, and Paste Cells 

Cutting, copying, and pasting are important operations for editing worksheets. They conform to the common 
conventions and use a buflFer called a clipboard for temporary storage. 

NOTE The difference between absolute and relative cell references is imfx>rtant when copying cells. When 
you copy a cell that contains a formula, In-Sight creates a new formula in the new cell. Absolute 
references remain unchanged, but relative references are edited to preserve equivalent offsets. 

NOTE You can use the copy-and-paste sequence to move cells between jobs. To do so, copy from the 
source job, load the target job, and paste into it. 

► To Cut Cells 


To remove the contents of a cell without copying it to the clipboard, clear it instead of cutting it. 

1 - Select the cell or range of cells you wish to remove from Ae woricsheeL 

2. Click and release the O button, opening the Edit menu 

3. Select Cut and click X In-Sight removes the selected cells from the worksheet and places in a 
clipboard, from which you can subsequently paste them. 

► To Copy Cells 


1 - Select the cell or range of cells you wish to copy. 

2. Click and release O, opening the Edit mena 

3. Select Copy and click X Leaving the selected cells in place, In-Sight copies them to a clipboard, 
from which you can subsequently paste them. 
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> To Paste Cells 

NOTE Pasting into an occiq)ied cell overwrites its contents without warning. 

1 . Cut or copy a cell or range of cells, as described above. 

2. Using the Control Pad, navigate to an empty or occupied worksheet cell. 

3 . Click and release O, opening the Edit mena 

4. Select Paste and click X In-Si^t copies the cells from the clipboard to the worksheet, overwriting 
any existing data. Absolute references remain unchanged, but relative references are adjusted to 
maintain equivalent relative relationships. 


A ► Worksheet: Clearing Cells 

Clearing a cell eliminates its contents without saving a copy to the clipboard Cutting a cell, in contrast, 
keeps a copy, typically as a way to move the cell through a subsequent paste. Use clear instead of cut to 
conserve memory when you want to permanently remove cells. 

► To Clear Cells 

NOTE The deletion is permanent You carmot undo it. 

1 . Select the cell or range of cells you wish to clear from the worksheet. 

2. Click and release the O button, opening the Edit menu . 

3. Select Clear and click X. In-Si^t clears the cells. 


A ► Worksheet: Enable or Disable a Cell 

Disabling a cell locks its value but leaves it in the worksheet In an apphcation, you typically disable a cell 
that implements a one-time set-up operation to prevent further evaluatioiL Calibration values, for example^ 
are good candidates for being disabled. During development, you can disable a cell isolate it, for example to 
help debug the worksheet. 

You can enable or disable a cell either manually or dynamically. You manually enable or disable through a 
toggle in a dialog. You dynamically enable or disable a cell through a relative or absolute reference to 
another cell, letting you lock or unlock the cell at run time. If the referenced cell evaluates to 0.0, then the 
referencing cell is disabled. If it evaluates to non-0.0, then the cell is enabled. 
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^ To Enable or Disable a Cell or Cell Range 

I Select or cell range. 

2. Click and release the O bunon, opening the Edit menu 

3. Select Cell State. In-Sight opens the Cell State dialog: 


Current state - 

Manually 
enable or disable • 
the eel! 


: CeBiiState -'^ 





' jk -Cancel-^: ^ 


4. Toggle Enable ON to enable the cell or OFF to disable it 

5. Click OK or Cancel. 


Dynamically enable 
by relative reference 

Dynamically enable 
by absolute reference 


^ A ► Worksheet: Hide Rows or Columns 

In-Sight Jets you hide rows or columns in the worksheet A common use is to simplify the appearance of the 
worksheet, either for an operator interface or as a convenience during development 

► To Hide Rows 

1 . Select the cell or range of cells to hide. 

2. Click and release the O button, opening the Edit mcnit 

3. Select Hide. In-Sight hides the rows. 

► To Unhide Rows 

1. xxxx 

2. XXXX. 

^ To Hide Columns 

1 . Select the cell or range of cells to hide. 

2. Click and release O, opening the Edit menu . 

3. Select Hide. In-Sight hides the rows. 

^ To Unhide Columns 


1. XXXX 

2. XXXX 
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^ A ► Worksheet: Insert or Remove Rows 

Inserting a row adds a new row ??beIow?? the current row. Removing a row permanentiy eliminates it 
NOTE These operations are available only for rows, not for columns. 

► To Insert a Row 

1 . Using the Control Pad, select any cell in the row ??above?? the one you want to insert 

2. Click and release the O button, opening the Edit menu . 

3. Select Insert Rows. In-Sight inserts one row ?below? the selected cell. 

► To Remove a Row 

CAUTION The deletion is permanent You cannot undo it. 

1 . Using the Control Pad, select one or more cells in one ??or more?? rows. 

2. Click and release O, opening the Edit menu. 

3 . Select Remove Rows. In-Sight removes the rows containing the selected cells. 



^ A ► Worksheet: Row Height, Column Width 

You can set the row height or column width to a convenient value. ??Same for all, or row-by-row and col- 
by-col?? 

► To Set the Row Height 

1 . Click and release the O button, opening the Edit menu . 

2. Select Row Height. 

3. In the text field, enter the number of pixels??. In-Sight resizes the rows. 

► To Set the Column Width 

1 . Select a column. 

2. Click and release O, opening the Edit menu . 

3. Select Col Width. 

4. In the text field, enter the number of pixels??. In-Sight resizes the columns. 
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^ A ► Worksheet: Customizing 

You can enable or disable worksheet elennents such as the typically to implement an operator interface. 
► To Toggle Worksheet Elements 

1 . Click and release the O button, opening the Edit menu . 

2. Select Worksheet, opening the Operator View dialog: 




worn 


Sets position of 
displayed WS pane 


Toggles Formuta Bar 
- Toggles column header ' 

Toggles row header 

-Toggles WS grid 

. Restricts scrollable 
area 


ExtractSoiia6b^$A$q:o,Q;0:a3;r^ 


} 

" A 


:_c. 

. . D : 



QjParallet 


QjTimer 




~.268J3S2-r 


\ 2- 

J- 


• 2333mz. 

A335.641 


. ^ ^- 4- 

I 2JHJ0 

■ 200372- 

499^2 

1 4. 

■* - 1 ■ 


•342.634 

41 9^ 

|o5- 



mmmm 

^^^1 


3 . Enable or disable the desired attribute. 
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^ A ► Formulas: Building Formulas 

The In-Si^t's worksheet interface lets you set up machine vision applications. This section discusses the 
following topics: 

• Using tlie Tn-Sight Worksheet 

• Entering a Fomiula 

• Placing a Value on the Worksheet 

• Creating an Absolute Reference 

• Creating a Relative Reference 

• Creating a Mixed Reference 

• Using Intet^active Reference Mode 

• EXPRESSION — discusses this menu item 

• Opening the Property Sheet from a Formula 

• Fonnula Syntax 

• Matli Functions and Operators 

• Dealing witli Errors. 

A cell is a location in the In-Sig}it worksheet identified by its row and column address. Each cell can hold a 
value, a string, an expression, or a structure. A value is a literal quantity, such as 1.00. A string is one or 
more alphanumeric characters surrounded by quotes, such as "string". An expression is a formula that 
evaluates to a value or string; the worksheet shows the result A structure encapsulates complex data, such 
as an image. When you create a stnicture, it often emits some of its data to the following cells thit)ugh 
"gener" functions; alternatively, you can reference the structure from a getter. 


^ A ► Formulas: Placing in the Worksheet 

The worksheet, where the real work gets done, is a simple spreadsheet. Like standard spreadsheets, the 
In-Sight worksheet is a table of cells with numbered columns (1 through 99) and lettered rows (A through 
Z). Each cell can have an associated formirla (an expression), and the floating-point result of the formula is 
the ceU*s value. The worksheet displays the active cell's coordinate (here, AI) in the upper-left comer, its 
fonnula (6-5) in the formula line, and its value ( 1 .000) in the cell. This layout will be natural to anyone familiar 
with standard spreadsheets. 


Image structure, 
stores acquired 
image 


Current cell^ — ~' 


Worksheet columns 
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You navigate from cell to cell with the cursor. At each new ceU, In-Sigjit updates the active cell and the 
formula line to reflect the current celJ. 


^ A ► Formulas: Entering 


AJl of the vision processing software is implemented as functions used inside fomiulas within a worksheet 
Constructing formulas therefore is a key aspect using the In-Sight SW. To simplify the task of creating and 
editing formulas, In-Sight offers dialog box called Formula Builder, shown below. 


Keypad -s.^^ 

Opens 
Text Entry - 


Absolute 
cell reference 


Relative 
cell reference 


Help text 



Vision Processinq 


^^oOTt^te: -Trarisf : 

^^jtiflC^pjtt^-i^f^^i 





To open the Formula Builder, select a ceU and click the X button. The resulting dialog has three panes. The 
lef\ pane offers a keypad, arithmetical operators, navigational controls, and other elements. The center and 
right panes offer hierarchical access to vision processing functions and to more general mathematical and 
spreadsheet functions. 

You manipulate the cursor to move around inside the Fomiula Builder to select constants, operators, and 
functions. In-Sight indicates selectable items in blue, unselectable items in black, and the current selection in 
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red. Clicking X inserts the current selection in the formula. For exan^jle, to insert the value "6" in cell Al 's 
formula, select the cell Al, clickX to open the Fonnula Builder, use the cursor to navigate to the digit 6 in 
the keypad, and then click X. As shown below, Formula Builder then inserts the value "6" in the formula. 


Constmcting a more sophisticated expression is simply a matter of repeating this basic sequence until all of 
the terms are present 


^ A ► Formulas: Placing a Value on the 
Worksheet 

The simplest formula is a static value, which remains constant when the worksheet updates. 

► Placing a Value on the Worksheet 
There is more than one way to do this. 

1- With the Control Pad, highlight the cell that will contain the value. 

2. Click and hold the X button, opening the Enter mailt 

3- Select Value. In-Sight hides the Enter menu and shows the worksheet 

4. To select the digit to edit, click Left or Right 

5- To increment the value, click Up. To decrement it, click Down. 

6. When you reach the desired value, click X to accept it. 


^ A ► Formulas: Create an Absolute Reference 

An absolute reference is a cell reference that that remains unchanged wiien copied to a new cell. For 
example, if ceU Dl contains a fonnula with an absolute reference to Al, and you copy Dl to El, then the 
new fonnula in El contains the same absolute reference to Al. With In-Sight, you can create an absolute 
reference from the Fonnula Builder, the Enter menu, or bvhand . 

► To Create an Absolute Reference from the Formula Builder 
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1 . With the Control Pad, highlight the cell that will contain the reference. 

2. Click and re lease the X button, opening the Formula Builder dialog. 


3. Click 


In-Sight hides the Formula Builder and shows the worksheet. 

4. Highlight the referenced cell, and then click X to accept the reference. In-Sight returns to the Formula 
Builder. 

5. When done with the formula, click OK 

^ To Create an Absolnte Reference from the Enter Menu 


[ 1 . With the Control Pad, highlight the cell that will contain the reference. 

( 2. Click and hold the X button, opening the Enter menu. 

3. Select Absolute. In-Sight hides the Enter menu and shows the worksheet 

4. Highlight the referenced cell, and then click X to create the reference. 

^ To Create an Absolute Reference from an Existing Reference 

1 . Using the Control Pad, highlight the cell containing an existing reference. 

2. Click and hold the X button, opening the Enter menu. 

3. Select Formula. In-Sight opens the Formula Builder with the existing reference in Formula Line, 
which is is pre-selected and ready for editing 

4. Click Left until the insertion point precedes the cell row value. 

5. Click Down to enter the keypad, highlight the $ buHon, and click X to insert the $ symbol that 
indicates an absolute reference. 

6. Click Up to enter Formula Line, move the insertion point in ftont of the column value, and similarly 
edit a $ symbol in front of the cell column value 

7. Click OK to accept the edited reference. 

See also Creatine a Mixed Reference and Creatine a Relative Reference . 


A ► Formulas: Create a Relative Reference 

A relative reference is a cell reference that changes v^^en copied to a new location, preserving the same 
offset relationship. For example, if cell Dl contains a formula with a relative reference to CI ("one above"), 
and you move Dl to Fl , then the new formula in Fl has a relative reference to El ("one above"). 

► To Create a Relative Reference from the Formula Builder 

1 . With the Control Pad, highlight the cell that will contain the reference. 

2. Click aiid re lease the X button, opening the Formula Builder dialog. 


m 


3. Click 

4. Highlight the refaienced cell, and then click X to accept the reference. In-Sight returns to the Formula 


. In-Sight hides the Formula Builder and shows the woricsheet. 
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Builder. 

5. When done with the formula, click OK. 

► To Create a Relative Reference from the Enter Menu 

1 . With the Control Pad, highlight the cell that will contain the reference. 

2. Click and hold the X button, opening the Enter menu. 

3. Select Relative. In-Sight hides the Enter menu and shows the worksheet. 

4. Highlight the referenced cell, and then click X to create the reference. 

► To Create a Relative Reference from an Existing Reference 

1 . Using the Control Pad, highlight the cell containing an existing refercaice. 

2. Click and hold the X button, opening the Enter menu. 

3. Select Formula. In-Sight opens the Formula Builder with the existing reference in Formula Lme, 
which is is pre-selected and ready for editing. 

4. Click Left, placing insertion point in between the $ symbol and the row or column value. 

5 . Click Down to enter the keypad, highlight the BS button, and click X to remove the $ symbol. 

6. If the existing reference contains a second $ symbol, click l^p to enter the Formula Line, and similariy 
remove the second $ symbol. 

7. Click OK to accept the edited reference. 

See also Creatim^ a n Ahsolute Reference and Creating a Mixed Reference . 



^ A ► Formulas: Create a Mixed Reference 

A mixed reference is a ceD reference where one cell coordinate is absolute and the other is relative. When 
you copy a cell containing a mixed reference to a new cell, the absolute part remains unchanged but the 
relative part changes to preserve the same offeet relationship. 

► To Create a Mixed Reference 

The only way to create a mixed reference is to edit a preexisting reference. 

1 . Using the Control Pad, highlight the ceU containing an existing reference. 

2. Click and hold the X button, opening the Enter menu. 

3. Select Formula. In-Sight opens the Fonnula Builder with the existing reference in Formula Line, 
which is is pre-selected and reacfy for editing. 

4. Click Left to placing insertion fx>int in front of the cell row or column value. 

5. Click Etown to enter the keypad, then edit the row and column coordinates as follows: 

o To change a relative coordinate into an absolute coordinate, highlight the $ button, and click X 

to insert the $ symbol that indicates an absolute reference, 
o To change an absolute coordinate into a relative coordinate, highlight the BS button, and click 


,0111446A2J_> 


Appendix I - Page 84 


I 

1 wo 01/11445 PCT/USOO/22383 

I ' 

i 
I 

I 

I X to remove the $ symbol. 

I 6. Click OK to accept the edited reference. 

I See also Creating an Ahsolme Reference and Creating a Relative Reference . 



A ► Formulas: Set Values Interactively 

??This should discuss the interactive methods for setting cell references. When you enter this mode, 
transparency is OFF, and the background color is a bit darker. 

Many fijnctions have parameters that defme the size, location, or angle of a geometric shape. For example, 
LineToCircleO 

measures the distance between a line and a circle. The line is defined by four values (for both end points, a row 
Often, the most convenient way to set these values is by manipulating an image of the shape with the Control P 

^ Using Interactive Reference Mode 

1 . Open a property sheet, and then select a heading for a parameter that can be set graphically. 

2. Click and hold the X button, opening the Enter menu. 

3. Select ???. In-Sight hides the worksheet and displays a cursor appropriate for the parairieters being 
set. For example, to set a circle, it displays a circular cursor. 

4. With the Control Pad cursor, manipulate the graphical cursor until it reflects your needs. 

5. When satisfied, click X, returning to the property sheet 

= == =_=__==__ CXSGIMEX InfiSight 

A ► Formulas: Open a Property Sheet 

??This topic discusses the VALUE item on the Enter menu 
^ Placing a Value on the Worksheet 
There is more than one way to do this. 

• XXX 

• XXX 

• XXX. 
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Insight) 


^ A > Formulas: Syntax 


??note that a vision tool can reside onJy at the top level. It can put its results into a ceU, but not into a 
fonnula. 

When you're editing a formula, you can generally ignore syntax, because Fonnula Builder automatically 
disables invalid characteis, preventing you from entering them. The following figure shows the fomiula syntax 
in gf^hical form. 
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Canpkx 


Contpkx- 



ii«f»b«f- 


A ► Formulas: Math Functions and 
Operators 

In-Sigjit offers a fixU compliment of conditional, logical, arithmetical, statistical, and trigonometric functions 
plus standard relational operators. Rules affecting the mathematical operations include the following: 

• To assure compatibility of all numeric values in the worksheet, In-Sight rqjresents all numbers as 
floating-point values. For example, it represents die integer 3 as 3.00. Similarly, for logical functions, it 
represents TRUE as non-0.00 and FALSE as 0.00. Eliminating the need for explicit numeric data 
types simplifies the task of developing spreadsheets for vision applications. 

• Some values are intrinsically integer. Supplying a fiactional value for an integer parameto* results in 
rounding to the nearest whole integer. For example, 3. 1 rounds to 3.000, but 3.7 rounds to 4.000. 

• The underlying precision (32-bit floating-point) exceeds its displayed precision (three decimal places). 
Confutations on floating-point values reflect the internal precision. 

• All indexes are zero-based. 

• A reference to an empty cell observes the following mles: 

o When referenced by functions that take cell-range arguments, the empty cell is ignored. For 
example, if A3:A5 are all empty, then Mean(l , A3:A5, 2, 3) returns 2, the average of the valid 
values 1, 2, and 3. The only exception is SumQ, which treats an empty cell as 0.0. 

o When referenced as a numeric or Boolean value, the en^ ty cell is evaluated as 0.0. For 
example, if AI is empty, then the formula 3.00 + Al evaluates to 3.00. Similarly, Abs(Al) 
returns 0.0. 

o When referenced as a string, the empty cell is evaluated as a null-string. For example, if A 1 is 
empty, then Concatenate(Al) returns a null {empty) string, 

• Error propagation: 
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o AndO. OrO, SumQ, Max(), MinQ, MeanO, and SDevQ ignore individual parameter that refer 

to error cells. If all input parameters are #ERR, then the result is #ERR. For example, Sum(2 

#ERR, 2) yields 4, but Sum(#ERR, #ERR) yields #ERR. 
o MaxIO and MinlQ assign indexes to all parameters that refer to error ceUs, but do not consider 

them when evaluating a result. For example, Maxl(0, 1, 2, #ERR, 15) returns 3.00, the zero 

based index of 15. 

For more information, see Mathematics Functions . 



^ A ► Formulas: Dealing with Errors 

On success, In-Sight functions return a value or a string. On failure, they return one of the values in the 
following table. 

Error Description 
#PARM Indicates an invalid parameter value. Generally occurs only when passing a value by cell 

reference, since the Formula BuildCT performs range checking. 
#£RR Indicates a general error. 

#TIMEOUTIndicates that a function timed out during execution. ??Can occur only if the timeout feature is 
enabled by XXXX. 
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^ A ► Vision and Worksheet 

I 

\ This section describes how to use the Formula Builder for vision processing: 

ft 

I • Default Acquisition References 

i • E>efining Regions of Interest 

1 ^ o Defining Rectangular ROls 

i' o Defining Curved, Circular, or Toroidal ROIs 

\ • Woii:ing with Fixaues 

( o image. Fixture, and Region Coordinate Systems 

o Fixture Example 
[ • Image Processing 

• Profiling Execution . 


V. 


^ A ► Vision: Default Acquisition References 

When the In-Sight software starts up, the worksheet contains some default references, as shown below: 











□iRiaBGl 



i 

Fir 







Stores Stores Stores Stores 

acquired parallel poft serial port a timer 
image settings settings 


^ A ► Vision: Region of Interest 

A region of interest (ROI) is an image area within which a function performs an image processing, feature 
extraction, or other operation. An ROI is commonly rectangular but sometimes angled, curved, circular, or 
toroidal. You define a rectangular ROI by its top-left point, its height and width in pixels, and its angle in 
countercloclcwise degrees: 
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The ROI center is usually the expected feature center The ROI size depends on positional and angular 
uncertainty. Keq)ing the ROI as small as practical reduces the number of pixels to process, reducing 
processing time. In-Sight supports several strategies for defining ROIs during application development and 
deployment In general, an ROI can be: 


• Fixed. The ROI parameters are unchanging values, defined eittier by editing them directiy in a 
property sheet or by referring to cells containing static values. 

• Interactive. You define die ROI with a graphic cursor drawn on the image and manipulated with the 
Control Pad. 

• Calculated. The ROI values derive from worksheet fomiulas that adjust them at run time. 

• Fixtured. The values are defined by row, column, and angle offsets fix)m a fixture coordinate system 
id«itified in each image. A special case of "calculated." 

For procedures used to define an ROL see Defining a Region of Interest . 

COGMEX Insight) 

^ A ► Vision: Rectangular Regions 

You can define a region of interest (ROn interactively, manuaflv, or by woiicsheet references You typically 
use the interactive method during developmait because it gives you immediate feedback about its size, 
location, angle, and curvature. You define the ROI manually when you know its exact parameters and pilfer 
to edit them as fixed numeric values. The worksheet method is common in applications that dynamically 
define the ROI based on computed rather than static values. 

► To Interactively Define a Rectangular ROI 

Dragging a interactive cursor over the image is a convenient way to define an ROI. When using the 
interactive Region cursor, clicking the Control PadO button cycles the cuiwr to set location, size, angle, and 
(in some contexts) curvature: 
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Position 


64 

Row 

The arrows on the "top" and "left" sides point away from the origin, for operations affected by the region's 
orientation. 

1 . In a property sheet, chck and release the Region header. In-Sight hides the property sheet draws the 
interactive region cursor on the image: 


Size 


Angle 


Curve 


Col 


247 - Wide 


High 




Degrees CCW 


Degrees Curvature 


2- To adjust the position, use the Control Pad to move the four-arrowed Region cursor until its center is 
at the intended center As the cursor moves, it indicates the its current row and column location. 

3 . To adjust the size, click O change the cursor to its two-airowed form, then resize the ROI horizontally 
or vertically. Up and Down set the height, and Left and Right set the width. The cursor indicates the 
current height and width values. 

4. To adjust the angle, change the cursor to its circular form, then adjust the angle, indicated in 
counterclockwise degrees. 

5. To adjust the curvature (when available), set the cursor to its curved form, then adjust the curvature. 

6. When satisfied with the ROI, click the A button to accept it. In-Sight returns to the property sheet. 

A region cannot extend outside the image. If the cursor hits an edge, it stops. 
► To Manually Define an ROI 

1 . Open a property sheet and select its Region heading, if present. 

2. Chck and hold the X button, yielding the Enter mena 

3. Click Cursor-Down to select Expand fiom the Enter menu, In-Sight opens the Region heading, 
showing the Row, Column, High, Wide, Angle, and (if available) Curve values. 

4. Select a Region parameter and edit its values. 

5. When done, click OK or Run to acc^t the values. 
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► To Define an ROI by Worksheet Reference 

1 - Create cells to serve as source of the region parameters— Row, Column, High, Wide, Angle and (if 
applicable) Curve, 

2. Open a property sheet and select its Region heading, if present 

3. Click and hold X, yielding the Enter menu. 

4. Click Cursor-Down to select Expand from the Enter mena In-Sight opens the Region heading, 
showing its values. 

5. Select one of the Region parameters. For example, select Row. 

6. Again click and hold X to open the Enter menu. 

7. Select Relative or Absolute, depending on the kind of reference desired. In-Sight displays the 
worksheet, where you select a cell as a reference source. 

8. Click X to accept the reference. 

9. Repeat for the other Region parameters. 

If you specify one of the ROI parameters by worksheet reference, then the worksheet value overrides the 
value set manually or interactively. 


^ A ► Vision: Curve, Circle, Torus 

hi some contexts, a region can be curved, circular, or toroidal (doughnut-shaped) instead of rectangular. 
This topic describes the interactive methods for defining non-rwtangular regions. 

► To Define an Curved ROI 

Defining a curved ROI is similar to defining a rectangular ROI, except for the additional curvature value: 

Position Size Angle Curve 

. 

r . 




V 

t 


■^.^ 24?- 


64 


Col 


Row 


4 

64 


247- Wide 


High 



Degrees CCW 



/ 


/ 


Degrees Curvature 


1. In a property sheet, click and release the Region header. In-Sight hides the property sheet draws the 
interactive region cursor on the image: 

2. Adjust the position, size, and angle. 

3. Adjust the curvature. ??Show this?? 


► To Define a Circular ROI ROI 
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You define a circular or toroidal ROI through a center point, an inner circle, and an outer circle. 

I . In a property sheet, click and release the Toms header and click X In-Sight hides the property sheet 
and displays an interactive cursor for defining circular or toroidal ROIs: 


2. 
3. 
4, 
5. 
6. 



This cursor has two forms, and the O button toggles between them. 

Adjust the location of the of the center point. 

Move the center of the cursor to the center of the desired region. 

Adjust the inner circle with the Up and Down buttons. 

Adjust the outer circle with the Left and Right buttons 

Click X to return to the property sheet. 


A region cannot extend outside the image. If the cursor hits an edge, it stops. 


^ A ► Vision: Working with Fixtures 

A Fixture/ is a reference coordinate system (row, column, and angle) identified in an image and subsequently 
used to define other points or regions through offsets. A typical application first identifies the fixture origin 
and angle through pattern matching, blob analysis, or some other technique. It then stores the fixture row, 
column, and angle values and uses it as a benchmark within the image. Other In-Sight fiinctions subsequently 
refer to the fixture point through its Fixture row, column, and theta values. 

This section introduces fixures, discussing the following topics: 

• Image, Fixture, and Region Coordinate Systems 

• Fixture Exanple 

Defining locations in fixtured coordinates instead of image coordinates can improve robustness by 
compensating for positional and angular uncertainty. It can also improve speed by allowing many subsequent 
operations to use smaller ROIs, angular tolerances, and so on. Another advantage is that distances measured 
in the fixtured coordinate system often apply more directly to the real-world item of interest 


1 .The name "Fixture" refers to mechanical forms or devices that hold parts in place for some machining or 
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manufacturing operations. 


^ A ► Vision: Coordinate Systems 

In-Sight employs a rigbt-hand coordinate system, with the origin at the top-left of the image. The reference 
point— located in the image by feature extraction or another method— is identified by its mw and column 
locations, in image coordinates, and by a counterclockwise angle. The foUowing figure shows the Image and 
Fixture coordinate systems: 



You define an ROI through its row, column, and angle offsets relative to the Fixture coordinate system, 
shown below: 


as 


Column (fcnqg^^ 



Fixture origin, or 
fixture pont 


For a rotated region, width is the arc distance along the center line. Rectangular regions can be viewed 
having an infinite angle: 


as 
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Uncu-ved Regkn 

region orlgn'^. ^ Width - 


Width (arc d istance at center) 


Curved Region 
regicvi cr'^'w\^ 



^ A ► Vision: Fixture Example 

?Woik in an example that looks like this: You can view a search (for exanple) as a two-step process. 
Finding the fixture origin and angle amounts to preliminary search for a major landmark in the image. Based 
on the preliminary Finding a feature of interest amounts to a second search that depends on the preliminary 
values. This hierarchical strategy often greatly reduces the risk of confiision or error because the "real" search 
can largely ignore positional and angular uncertainty, which are absorbed by the fixture point. 

Consider, for instance, an application that checks the fill level in a bottling line. 

1 . Find the shape of the bottle though blob analysis. 

2. Set the Fixture origin to the blob's centroid and the fixture theta to its major axis. 

3. Define an ROI by offeets from the Fixture origin. 

4. In the ROI, detect an edge parallel to the Fixture Y axis. Applying the feature extraction in a fixtured 
ROI instead of the general image often greatly reduces the risk of confiision with background features 
that h^pen to resemble the feature of interest. 

5. Measure the X distance ftom the edge to the Fixture origin. Because this measurement occurs in the 
Fixtured coordinates, it is unaffected by angular variation in the image. 

6. Compare the measured distance to some pass-fail standard. 


^ A ► Vision: Image Processing 

?? All this has changed?? 


SOOCJD: <WO 0111445A?_I_> 


Appendix I - Page 95 


wo 01/11445 


PCT/USOO/22383 


Many vision applications enhance the image with filters or other image processing operations before 
extracting features from it You ^>ecify a sequence of image-processing operations ??? function's Script 
parameter 



- Edits Execution Order 


Parameters 
' (by cell reference) 

Parameters 
(by value) 

Dialog area: 
opaque or 
transparent 


Help for 
function or 
parameter 


• To add an operation, highlight it in the Selection list and clickX . The new item appears in the 
Execution Order list immediately after the item currentiy selected there. 

• To change the execution order, select an item in the Execution Order hst and click Up. Down, or 
Delete. 

• To view the results of the image processing operations, scroll in the Execution Order pane. At each 
step, TBD updates the ROI to show the cumulative affect of the script up to that point. 

• If the ROI overlaps with the dialog, it is sometimes hard to read the dialog whai displayed at the same 
time as the image. To suppress transparency, click Opaque; to return to simultaneous display, click 
Show Image. 


COGMEX lr>(Sight; 

^ A ► Vision: Profiling Execution 

The Profiler gives you information about execution times within the worksheet, to help you optimize it 
► To ProHle Execution 

1 . Click and release the A button, opening the System mena 

2 . Select ProfUer and then click X. In-Sight displays the Profile dialog: 


f 
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^ A ► Options: Introduction 

??You set up various system options thorough dialog boxes opened from the System mena This section 
details the options, discussing the following topics: 

• Se tting UP a Serial Port 

• Setting up Discrete In 

• Setting up Discrete Out 

• Setting the Password 

• Setting Startup Options 

• Customizing the Interface 

• Setting Advanced Options 

• Saving the Settings 

• ??En-or Handling 

• Getting the In-Sight Version Number 

• Obtaining Online Help 



^ A ► Options: Setting Up the Serial Port 

If your application uses serial communications, you must define the properties of the serial port 
► To Set Up the Serial Port 

1 . Click and release the Abutton, opening the System menu . 

2. Select Options, opening the Options menu. 

3. Select Serial Port, opening the Serial Port dialog. 



4. Set the values applicable to your serial device. 
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M A ^ Options: Setting up Discrete Input 

In-Sight offers up to 10 discrete inputs and 10 discrete outpute. In hardware, each line is a hot/ground pair 
of screw tenninals used to connect photocells, pressure sensors, warning lights, and other I/O devices. The 
external inputs are numbered 0 through 7, to agree with the labels printed on the I/O Expansion Module. The 
built-in inputs are numbered 8 and 9. 

h To Set up Discrete In 

1 . Click and release opening the System menu . 

2. Select Settings and then click opening the Settings mena 

3. Select Discrete Irqjut, yielding the Discrete Input dialog: 



4. Click Details: 



The parameters are: 


SDOCID: <WO_01 1 1 445A?_L> 


Appendix I - Page 99 


wo 01/11445 


PCT/USOO/22383 


o Name. A text label. 

o Debounce time. Allows In-Sight to ignore changes in the signal for a specified number of 

milliseconds after a transition, preventing it from misinterpreting noise as a new transition. 

Mechanical relays, for example, tend to produce noisy signals that require debouncing, 
o Invert polarity. When OFF (the default), polarity is acdve-higji, so the transition from Ov to 

1 2v DC indicates ON. When ON, polarity is active-low, so the transition to Ov E>C indicates 

ON. 



^ A ► Options: Setting up Discrete Output 

??This one talks about discrete out?? The external outputs are numbered 0 through 7, to agree with the 
labels printed on the I/O Expansion Module. The built-in outputs are numbered 8 and 9. 

^ To Set up Discrete Out 

1 . Click and release A, opening the System menu . 

2. Select Settings and then click >s opening the Settings mena 

3 . Select Discrete Output, yielding the Discrete Output dialog: 



4. Click Details. You get: 
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The parameters are: 

o Name. A text label, 
o Forcing. 

o Invert polarity. When OFF (the default), polarity is active-high, so fa-Sight switches from Ov to 
12v DC to indicate ON. When ON, polarity is active-low, so the transition to Ov E>C indicates 
ON. 

o Output scheduling 

o Delayed 

o Pulsed output 



^ A ► Options: Setting the Password 

??all of this has probably changed?? The fa-Sight software has one level of password protection, "unlocked" 
versus "locked": 


• When locked, the operator can view the image but cannot view or change the job settings. When 
locked, pressing any button yields the Unlock dialog. The only way "in" is to enter the correct 
password, a user-assigned string. 

• When unlocked, the operator can view or change any parameter. When unlocked, the user can lock 
the software by selecting Lock, yielding the Lock dialog, shown below. After siqplying and 
confirming a password, fa-Sight toggles to "locked" 

There is no password dialog as such. Locking the system always requires entering a password twice. The 
new password might or might not match the previous password. The password could potentially change 
every time the software is locked; unlocking always requires the previous password. 

The menu label changes according to its state. TThe software can be locked or unlocked at startup, 
depending on an option in the Options dialog.? 

^ To Lock (he System 

1 . Click and release the A button, op)ening the System menu . 

2. From the System menu, select Lock and then cUck X fa-Sight displays the Lock dialog: 


SOOCID: <WO 01 1 1445A2J_> 


Appendix I - Page 101 


wo 01/11445 


PCT/USOO/22383 



3. ??Whatelse?? 



^ A ► Options: Setting Startup Options 

If your application uses serial communications, you must define the properties of the serial port 
> To Set Up Startup Options 

1 . Click and release the A button, opening the System menu. 

2. Select Settings, opening the Settings menu. 

3 . Select Startup, opening the Starti5> dialog. 



4. Set the applicable values. 
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^ A ► Options: Language and Color Scheme 

In-Sight collects genera! system options in the Customize Dialog. This state is written to flash memory on an 
ongoing basis. 

^ To Set an Option 

1 . Click and release the A button, opening the Systaii mena 

2. Select Options, opening the Options mena 

3. Select Customize, opening the Customize dialog. 



4. Select the desired options, described below: 

Option Description 
Language The language used for the built-in help text If you change the language and can't get back: 
(1) dick □ to open the System menu; (2) Select the last item in the System menu and click 
X, opening the Options menu; (3) Select the first item and click X, oj>ening the Customize 
dialog (4) Click Cursor Left to activate the Left pane; and (5) Select a language you can 
read. 

Transparency Controls the blend between the image and the worksheet for simultaneous display. The valid 

range is 0 to 100, v^ere small values lighten the image and large values daricen it 
Cursor Blink Sets the rate of the blinking highhght that indicates the current selection, in milliseconds. The 

valid range is 0 (off) to 9999 (almost ten seconds). 
Auto Repeat Defines the duration of a single click for the Control Pad, in milliseconds. Holding down a 
I^elay button beyond this value cause it to automatically repeat the keystroke. The valid range is 0 

(off) to 9999 (almost ten seconds). 
Auto Repeat Sets the duration of each keystroke automatically generated after holding down a button 
Rate beyond the Auto Repeat Delay. The valid range is 0 (off) to 9999 (ahnost ten seconds). 

Color Scheme Controls the overall appearance of the graphical interface. In-Sight draws the worksheet 

and other GUI elements on top of the acquired grayscale image. It depends on color to 

separate the GUI fiiom the image. 


The following table shows the default color conventions. 
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Color Meaning 
Light yellow The background color for menus, dialog boxes, and so forth. 
Blue "Hot" text, potentially selectable. The primary color contrast is blue-on-yellow. 

Red text, flashing The ciurent position in a menu or dialog. A second cue for "current position" is the 3D 
bhie highlighting ^lied to the cumait item 

Black Unselectable text. Equivalent to "grayed out" in many GUIs. 

==—————— — — COGIMEX In^lgh^ 

^ A ► Options: Setting Advanced Options 

??Tells about the Advanced Options 

^ To Set Advanced Options 

1 . Chck and release the A button, opening the System menu. 

2. Select Settings, opening the Settings menu. 

3. Select Advanced, of)ening the Advanced dialog: 



4. Set appHcable values. 

— — ===— =_= =COGMEX Insight) 

^ A ► Options: Saving Settings 
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I 

I Settings are ??what??: 

\ ►To Save the Settings 

I I . Click and release the A button, opening the System menu . 

^ 2. Select??? and then click X.In-Sight???. 

I 3. Click A to close the System menu. 



\ ^ A ► Options: Setting up Error Handling 

' TrUm stuff moved to discrete I/OYou use the Error Handling dialog to control how In-Si^t responds to 

[ errors in a production environment 

► To Set Up Error Handling 

1 . Click and release A» opening the System menu. 

2. Select Error Handling and thai click >s opening the Error Handling dialog: 



The parameters are: 

o Missed acquisitioa None, Go Offline, or Reboot. ?Maybe this should be reset?? 
o Tracking overrun. None, Go Offline, or Reboot, 
o Track Queue full. None, Go Offline, or Reboot. 
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^ A ► Options: Software Version 

??TaIks about the Version option on the System menu. 



^ A ► Options: Online Help 


In-Sight offers built-in help messages displayed in the Fomiula Builder, the property sheets, and elsewhere; i 
the interface. The messages aim to provide a basic description of each function or parameter in context 

?? Will we offer context sensitivity to this CHM file?? 
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^ A ^ Operator Interface: Building 

In-Sight offers several features for rearranging and reformatting the worksheet, for instance to 
simplify the view presented to an operator. Resources for this step include: 

• Hiding rows or columns , to simplify the worksheet. 

• Cu stomizing the worksheet , enabling or disabling its grid lines, row headers, column headers, 
expression line, scrollable area, and other attributes. 

• Creating graphics for user input through Button , CheckBox, Editint , or Li stBox . 

• Creating graphics for user output through Status, which colors a cell green, yellow, or red, 
according to its value. 

• Creating charts for user output. 

• Locking the lob , to prevent unauthorized change. 

• Disablin g individual cells , to prevent unauthorized change. 

• Changing the color scheme . 

These mechanisms let give you considerable control over system as viewed by the operator or 
other end user. 
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^ A ► Server: About 

The In-Si^ server (isserver.exe) is Microsoft Windows NT program that accompanies the In-Si^t 
hardware and communicates with it over a serial line. Its general behavior is similar to other MS \\^mdows 
programs. To use it, you select commands from menus using the mouse, through keyboard shortcuts, or by 
clicking icons in the toolbar 



Its capabilities include: 


• Issuing remote commands to In-Sigjit (acquire an image, read cell values, write cell values, and so 
on). 

• Archiving jobs, images, or settings from the In-Sight hardware to a PC. 

• Keyboard control, bypassing the Control Pad. 

• New sessions or job files ??what is this about?? 

• Saving the terminal session to a file for lata* review. 

This section describes the server's In-Sight-specific behavior, discussing the following topics: 

• Configuring the Server . Running Tn-Sight bv Keyboard 

• Issuing Server Commands . Server Commands Reference . 

• Saving Jobs. Images, and Settings 


To install the server program, see Installing the SoftAwe . 

— =============^ — =COGIMEX Insight) 

^ A ► Server: Configuring 

To run the In-Si^t server, you configure the In-Si^t software and the server software with compatible 
communications settings. 
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^ To Configure the IiwSight Server 

1 . If necessary, connect the Vision Processor to a COMM port on the PC with a serial cable and install 
the Server program. 

2. Start up the In-Si^ hardware. 

3- Configure one of In-Sight's serial ports: 

a. Click A to open the System menu. 

b. Select I/O Settings and click X to open the I/O Settings menu. 

c. Select either Port 0 or Port I and click X to open the Port dialog. 

d. Set Mode to Server and the Status to Open: 



In Server mode, inapplicable options are grayed out. 


e. Click OK to accept. 

4. Start the In-Sight server program, isserver.exe. 

5. Configure t he ser ver to agree with the COMM port in use: 

a. Click! 
dialog: 


I or select Port Settings fiiom In-Sight menu. The server opens the Port Settings 


Pofl Settings 


b. Set Port to COMMl , COMM2, COMM3, or COMM4, depending on the port in use on the 
PC. 

c. Set the baud rate to ??? 
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d. Click OK to accept the changes or Cancel to close. On success, the server issues a Port 
Opened message. 

To exit the server program, select Exit from the File menu. 


^ A ► Server: Issuing Server Commands 

The In-Sight server can issue commands to the LvSight hardware over a serial connection. For example, 
you can trigger an acquisition, read cell values, or write cell values (including valid fomiulas): 


fe- Sessioni 


mmmmt 

iPoxt opened 


m 

I >getcell a5 

Read cell A5 


|A5: 5.2 

CujTenl value = 5,2 


I >setcell aS 12.5 

Write 12.5 toA5 

m 

i >getcell a5 

Read cell A5 

• 

|A5: 12.5 

New value = 12.5 

is 

i > 







The In-Sight server generally behaves like most terminal programs: you type commands and their arguments 
at a prompt and view the data retumed. 

► To Issue Serial Commands to In-Sigbt 


1. 

2. 


Start and configure the In-Sight server program and hardware. 
At the prompt, enter a valid command: 

o Formulas passed as arguments to the setcell command are entered into a cell exactly as if they 
were entered through die Control Pad For example, setcell Al Abs(-25) places the 
expression Abs(-25) in cell Al, where it is evaluated to 25. 
o Cell refCTences and fonnulas are case-insensitive. 


For command syntax, type help or see Server Commands . 
3 . Enter a carriage return. The server confirms that the command is valid If valid, the server sends the 
command to the In-Sight hardware, which executes the conmiand For some commands, the 
hardware sends data or a message back to the server, which prints the text on the next line. 

The toolbar lists session-related commands: 


Create new Save active Serial port File transfer Keyboard 
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^ A ► Server: Saving Jobs, Images, Settings 

The In-Sight server can copy jobs, images, or settings from the hardware to the PC or from the PC to the 
hardware. The server therefore provides the mechanism to archive production applications and to transfer 
infonnation from one In-Sight system to another. 

After you have established a connection, you can initiate the transfer from either the bvSight server or the 
In-Sight hardware. This topic describes how to 

^ To Save Jobs, Images, or Settings 

1 . Start and configure the In-Sight server program and hardware. 

2. Click l^i or select File Transfer from the In-Sight menu. The server opens the File Transfer dialog: 


File Tiansfer 




3. To select a working directory on the PC, click Browse and designate a directory through the resulting 
dialog. 

4. Click Jobs, Images, or Settings to specify the type of data to transfer. 

5. To transfer data from the hardware to the PC, click ^H. To transfer data from the PC to the 
hardware, click k^J, 
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NOTE • An image file contains almost 500 KB of data. The transfer time depends on 
connection speed and can be lengthy for slow connections. 
• Image file names are assigned sequentally starting with ImgOOl .bmp. You cannot 
specify the file names. 

6. When done with the File Transfer dialog, click Hide to close it 


^ A ► Server: Running In-Sight by Keyboard 

The In-Sight server can pass text entered on the PC keyboard to the In-Sight hardware. With this technique, 
you can select functions by typing their names and enter text comments fiom the keyboard instead of the 
Control Pad. In-Sight behaves as if you had connected the keyboard to it directly. You can select function 
by matching their names, navigate with the keyboard cursor, and so on. 

> To Run In-Sight by Keybctard 

1 - Start and configure the In-Sight server program and hardware. 


2. 
3. 


Click 12^ or select Keyboard Pass-Through fiom the In-Sight mena 

At the sender prompt, enter a cell address followed by a carriage return. The In-Si^t hardware opens 
the Fonnula Builder dialog ready to enter a string, function, or formula in the specified cell: 



'»§r i alicq nn ectidri ^ - 



At the server prompt, type in an alphanumeric string. The server passes the string to the In-Sight 
hardware, which displays it at the top of the Formula Builder dialog. In the right-hand pane, the 
In-Sight lists functions that match the current string (case-insensitive). Adding letters progressively 
shortens the list: 

o For a unique match, In-Sight selects the matched function. Enter an open-parenthesis to delimit 
the parameter list, continue typing the comma-delimited parameters, and tenninate the list with 
a close-parenthesis. 
For no match, ??What happens?? 
For incorrect syntax, ??What happens?? 
When done with the string, enter a carriage return. In-Sight puts the finished fiinction in the selected 
celL 


o 
o 


Keyboard usage over the the serial connection is: 
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In-Sight displays an image on a standard VGA monitor connected through a standard 1 5-pin connector. 


^ To Connect a Monitor 

1 . Obtain a VGA-conpatible monitor or flat-panel LCD display. 

2. Remove the power from the Vision Processor. 

3. Plug the monitor's video cable into the Vision Processor's VGA port 

4. Lock down the connector with its screws. 

For details about the monitor signals, see Monitor Output , 


In-Sight provides two high-speed (115 kbaud) RS-232 serial ports for local communication with a PC or 
other devices. Serial ports 0 and 1 both use an RJ-45 connector instead of the more common DB-9 or 
DB-25 connector. You can use a Category 5 cable for serial communications, converting to DB-9 or 
DB-25 through an adapter if necessary. To accommodate DB-9 devices, In-Sight ships with an adapter 
(P/N XXX-YYY) that has RJ-45 on one side and DB-9 on the other. 

In-Sight includes a ?10-foot? Categoiy 5 cable for serial communications. Maximum si^ported cable length 
is ?? feet. 



VGA Display 


COGNEX ImSlght) 


^ A ► Install: Serial Device 



C0MM1. C0MrvT2. 
C0MM3. C0MM4 


Serial Cable 
??with adapter?? 


Serial 0 or Serial 1 
(RJ-45 connectors) 
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CAUTION The Vision Processor has three RJ-45 connectors, one for the camera and two for the serial 

ports. Make sure you plug each device into the correct connector. Plugging a serial device into 
the camera port can damage the serial device, the Vision Processor, or both. 

► To Connect a DB-9 Serial Device 

1 . Remove power from the Vision Processor. 

2. Plug one end of a Category 5 cable into one of the Vision Processor's serial ports, labeled SERIAL 0 


I and SERIAL 1 


3 . Plug the other end of the cable into the RJ-45 side of the serial adapter. 

4. Plug the DB-9 side of the adapter into the serial device (or, if you need more length, into a DB-9 
cable). 

5. To prevent strain on the connectors, fasten the serial cable to secure points near both ends, allowing 
some slack between the fasteners and the connectors. 

6. Define the properties of the serial port though the Seriai Port dialog . 

► To Connect an RJ-45 Serial Device 

1 . Phig one end of a Category 5 cable into one of the Vision Processor's serial ports. 

2. Plug the other end of the Category 5 cable into the serial device. 

3. To prevent strain on the connectors, festen the serial cable to secure points near both ends, allowing 
some slack between the fasteners and the connectors. 

4. Define the properties of the serial port feough the Serial Port dialo g. 

For hardware details about the serial ports, see Serial Ports . For details about serial communications, see 
Inpiit/Outoui Functions , 


^ A ► Install: Built-in Discrete I/O 

bi-Sight offers a total often discrete inputs and ten discrete ouQjuts for general-purpose use. Two iiputs and 
two outputs arc built in to the Vision Processor. The remaining ii^uts and outputs require an external 1/Q 
Expansion Module. Each discrete I/O signal is electrically independent fitim the others. All are optically 
isolated. 

You connect each discrete I/O line to the Vision Processor through positive and negative screw tominals on 
an intermediate, detachable terminal block, which bundles the wires together for easy assembly and 
reassembly. Wiring size is 22 to 14 AWG. 
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Twisted pair or 
other wiring 



PLC or 
other device 


8-pin 
Terminal Block 


1/0 Port 
(8-pin Terminal) 


^ To Connect a Discrete Input or Output 


J. 


On the 8-position terminal block, insert the positive wire into the positive terminal and the negative 
wire into the negative terminal. 


p p 1 1 i i I ■ 


IN 8+ / 
IN 8- 


—r 

IN9 


/ / j 

/ 0UT8* I 


OUTS ♦ I OUT 9*) 
IN 9- OUT 8- 0UT9- 


2. 
3. 
4. 
5. 
6. 


Tighten the set screws. 

Similarly connect any additional discrete ii^uts and outputs to the terminal block. 

Remove the power from the Vision Processor. 

Plug the terminal block into the Vision Processor's 8-pin I/O port. 

To prevent strain on the connectors, fasten the discrete I/O wires to a secure point near the Vision 
Processor, allowing some slack between the fastener and the terminal block. 
Define the properties of each input or output as described in Setting Uo I/O Qpn'ons . 


For hardware details about the I/O signals, see Built-in Discrete I/O . 


^ A ► Install: External Discrete I/O 


In-Sight offers a total often discrete inputs and ten discrete outputs for general-purpose use. Two inputs and 
two outputs are built in to the Vision Processor. The remaining inputs and outputs require an optional 
external I/O Expansion Module (P/N XXX-YYYY). This topic describes how to connect the I/O Module 
to the Vision Processor and how to connect input and ou^ut lines to the I/O Module. 
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PLC or 
other device 


Twisted pair or 
pther wiring 



External I/O 
module 


/ 

External I/O 
cable 


EXTERNAL port 
p6-pin connector) 


CAL'TION The External I/O module must have exactly the same ground potential as the Vision Processor 
chassis. Any difference in potential creates a ground loop that can damage the equipment. 
Nomially, the I/O module's housing electrically isolates it from its attachment point, allowing 
the Vision Processor to supply a ground through the External I/O cable. If you connect a 
ground wire to the I/O module's ground screw, then that ground must be electrical identical to 
the Vision Processor's ground. 


^ To Connect the I/O Module 


1 . Attach the External I/O Module to a convenient surface. It is configured for a standard #3 DIN rail 
mounting. 

2. Remove the power from the Vision Processor. 

3. Plug one end of the External I/O cable into the I/O Module's 26-pin connector and the other end into 
the Vision Processor's 26^in EXTERNAL I/O port 

4. Connect any input lines to the input screw tenninals on the I/O module and tighten the set screws. 

5. Connect any output lines to the ou^ut screw tenninals on the I/O module and tighten the set screws. 


NOTE The Vision Processor supplies power to the I/O Module, which therefore does not require an 
external power supply. 



^ A ► Install: Power Supply 

In-Sight requires a 24-volt DC power supply. The voltage tolerance is ± 5 percent, and the maximum power 
I consumption is 1 .0 Amp. You connect the power supply wires (22 to 14 AWG) to the Vision Processor 

through screw tenninals on an intermediate, detachable tennina] block, which bundles the wir^ together for 
easy assembly and reassembly. 

j Some In-Sight configurations include an AC adapter (P/N XXX- YYYY) that converts 1 OOv to 240v AC 

(50 to 60 Hz) line cunent to 24v DC; other configurations assume you already have a 24v DC power 
\ source. 
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! ► To Connect a Power Supply 

I 

\ CAUTION Incorrect voltage creates a risk of fire or shock aiid can damage the In-Sight hardware. Never 
[ connect voltages other than 24v DC to the Vision Processor. 

• CAD rJON Incorrect polarity can damage the In-Sight hardware. The probable result is a blown fiise, 
i which automatically resets itself v/hcn you remove the power. The fuse is NOT user- 

[ replaceable if it does not reset itself Always observe the polarity marked on the Vision 

I Processor. 


L On the terminal block (Cognex P/N XXX- YYY. or Phoenix Connector # 1 803578), connect the 
positive wire to the positive screw tenninal and the negative wire to the negative (ground) screw 
tenninal: 



Ground 24 VDC 


??If you are using the Cognex AC adapter, the positive wire has a white stripe and a rough texture, 
and the negative wire has no white strij>e and a smooth texture. You can extend the three-foot DC 
leads as needed with suitable two-conductor wiring. If the AC plug does not match your local power 
service, you can remove the AC cord and replace it with a local equivalent. 

2. Tighten the set screws. 

3. Plug the terminal block into the Vision Processor's 24 VE>C port. 

4. Route the power supply wires away from sources of high-voltage power. This precaution reduces the 
risk of damage or malfunction due to overvoltage, noise, power surge, electrostatic discharge (ESD), 
and other irregularities. 

5. To prevent strain on the connector, fasten the power wires to a secure point near the Vision 
Processor, allowing some slack between the fastener and the Vision Processor. 

6. Turn the power ON. To confirm that power is present, check the LED indicator at the left side of the 
front panel. If the LED is dark and you believe you that power is present, one possible problem is a 
blown fuse. Confirm that power is present and has the correct polarity. 

For power supply details, see Power Supply Reference , 
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^ A ► Install: In-Sight Software 

The vision processing software is built into the In-Sight hardware and does not require installation. This topic 
describes how to install the server software and online documentation on a Microsoft Windows NT system. 

► To Install the Software and Documentation 

1 . Before inserting the In-Sight CD-ROM in a CD-ROM drive, shut down any nmning applications. 

2 . Insert the Cognex In-Sight installation CD-ROM into your computer's CD-ROM drive. 

3 . Follow the setup dialogs as they appear on screen. The default installation directory for Windows NT 
is C:\Program FilesMn-S^ht. We recommend accepting the default. 

4. When the installation program terminates, remove the In-Sight installation disk fiom your CD-ROM 
drive. 

5 . Test the online documentation, distributed as a compiled HtmlHelp file, by double-nclicking the 
C:\Program FflesMn-SightMn-Sight.chm file. If you cannot open In-Si^t.chm, then: 

a. Open Microsoft hitemet Explorer and check the version number. To view the online 
documentation 0, you must have IE 4.0 or higher. If you do not have Internet Explorer or have 
an older version, then update your system with a current version. 

b. If you have IE 4.0 and stiU cannot open In-Sight.chm, then run hhupd.exe, an iipdate program 
suppUed on the In-Sight CD-ROM. Early versions of IE 4.0 recognize conpiled HtmlHelp 
(.chm) files unless they are updated. Later versions do not require updating. 

6. Running the Server program requires at least one enabled serial port. If you attempt to run the server 
program and receive a "can't open port" error, then you must enable the port on the PC. This usually 
requires changing a setting in the PC's BIOS through the BIOS Setup Utility, opened by pressing Fl 
during startup. * 


Files installed include: 


Description 

In-Sight server program 
HtmlHelp fae 

Updates IE 4.0 to nm compiled HtmlHelp Files 

Up-to-date information si^jplementing the standard documentation. 



^ A ► Install: Testing the Installation 

You test the installation by starting In-Sight and viewing an image. 


FOe 
isserver.exe 
In-Sight.chm 
hhupd.exe 
readme.txt 
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^ To Test the Installation 

I 1 . Switch on the VGA monitor 

I 2. Apply power to the In-Sight processor. 

I 3. Look for the In-Sight splash screen. 

I 4. On the Control Pad, click A In-Sight opens the System menu. 

I 5. From the System menu, click I>own to highlight the Live option. 

: 6. Click X. In-Sight hides the worksheet and displays a live image. 

I 7. Adjust the camera and lens; 

I o If the image is completely black, maybe the camera is improperiy connected; or maybe the 

I aperture is closed; or maybe there is insufficient light. Check the light, lens, and cable, 

I ' o If the image is bluny, completely gray, or completely white, adjust the camera's position, focus 

[ ring, and aperture ring until a sharp image appears on the display. 

? 8. Press any button to halt live video test. 


^ A ► Install: Testing the Lights 

After In-Sight starts successfiilly, you can test variable-intensity lights (if present) 
^ To Test the Lights 

1. ??From the TBD menu, select TBD, and TBD. 

2. ??In the Acquirelmage function, set the light intensity value to ???. The lights should increase to 
maximum brightness. 

3. Set light mode value to ??. The li^ts should ??do what??. 

o If the LEDs remain unlit, the lighting cable may be loose. If it is not loose, contact Cognex as 

described in Customer Support , 
o If the LEDs are lit, but do not change in intensity as you adjust the light mode value, make sure 

the lighting cable is connected to the correct lighting port 


.JL ^ Install: Updating Firmware 

The In-Sight system includes built-in software for its user interface, vision processing functions, and so on. If 
it becomes necessary to update this software, Cognex will issue a revised version that you can transfer to the 
Vision Processor. This section describes the procedure for updating the firmware, 

► To Update the In-Sight Firmware 

I. TBD 
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2. TBD 

3. TBD. 

^ To Change or Update the Help Language 

1. TBD 

2. TBD 

3. TBD. 


A. ► Install: Start up and Shut Down 

In-Sight starts up as soon as you apply power and runs continuously as long as power is present. It does not 
have a power switch. You can reset the hardware by inttenqjting the power. All unsaved data is lost at 
power down. 

► ToStariUpIn-Sight 

1 . Turn on the power. In-Sight starts iq>, ?displays its splash screen,? and immediately starts 
executing ??w^ch job??. Goes online inmiediately if so configured 

► To Shut Down In-Sight 

??No special shut down procedure, other than saving your work?? 

1 . Save any changes in the current jobs. 

2 . Turn OFF the power. 


^ A ► Install: Troubleshooting 


Symptom 
Power LED Dark 


Possible Cause 

1 . No power. 

2. Polarity reversed. 

3. Blown fuse. 


1. 

2. 


3. 


Possible Solution 

Confirm that 24v DC is present. 
Check the wiring. Reversed polarity should trip the 
flise. Intem^ting the power to correct the wiring 
should reset the fuse. 

Interrupt the power. The fiise resets automatically. 
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Image black. 

1 . Camera or monitor 

1 . Double-check the connections. In particular, make 

power LED lit 

misconnected. 

sure you haven't reversed the serial and camera 


2. No light on 

cables, vMch both use RJ-45 connectors 


subject. 

2. Confinn illumination. 


3. Aperture closed. 

3. Open the lens aperture ring. 

Image gray, white. 

Poor focus 

Focus the lens. 


or blurry 
I/O lines fail 

In-Sight server 
issues "can't open 
port" error. 

Online 

documentation 
won't open 


Misconnected or 
disconnected 

Serial port disabled 


Wrong browser version 


Confirm the electrical continuity. 

Enable the port on the PC. This usually requires changing a 
setting in the PC's BIOS through the BIOS Setup Utility, 
opened by pressing Fl during startup. 

• HtmlHelp requires Microsoft Intemet Explorer 4.0 or 
higha*. If you're running an older version, you must 
upgrade, 

• Some versions of IE 4.0 require additional software 
components to recognize a compiled HtmlHelp file. 
Try running the updater (hhiqxLexe). supplied on the 
bvSight CD-ROM. 
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^ A ► Getting Started with In-Sight 

This section gives you a hands-on introduction to the In-Si^t system. Using an image of an industrial port, it 
walks you through a sequence of stqjs common in real-worid aj^hcations. To get the most benefit from this 
exercise, you should follow along on your own system, giving you first-hand experience with the Control Pad 
and worksheet 

The goal is to measure the distance between a curved edge and a straight edge. This measurement depends 
on finding both edges, even if the part shifts around fiom one image to the next The underlying edge- 
detection steps are straightforeward when considered in isolation. Compensating for differences in location 
and orientation — crucial for making sure an application is rehable — adds some preliminary steps. The overall 
flow is: 

1. Acquire an linage of the Part 

2. Fixture the Part 

3. Locate Featiies: Straidit Edge 

4. Locate Features: Curved Edge 

5. Measure tlie Distance 

6. Save the Job . 

When you're done, you'D have a major part of an inspection application— w/Z/row/ writing a single line of 
code, 

Don*t wony if this section mentions topics without completely explaining them. The idea is to capture the 
flavor of using In-Sight, not to exhaustively explore it When done, you should go on to read Vsin^ the 
InSight Interface, which details how to use In-Sight*s GUI. You then should be ready to start developing 
your own vision apphcations, referring to this online book for more information whenever you need it 


^ A ► Getting Started: Acquire an Image 

In this section, you acquire an image that serves as the starting point for the rest of the exercise. 


► To Acquire an Image of the Part 


Before you can follow this exercise, first install and start the In-Si^t system. On startup, In-Sight 
displays a worksheet, where you define fomiulas for vision processing. Through a semi-transparent 
overlay, it simultaneously displays the acquired image. This feature, called worksheet overlay, 
ehminates the need to alternate between the image and worksheet— a major convenience when setting 
up a woiteheet based on the features in an image. The amount of transparency is adjustable. 

DisTDlav the sample imagre (a generalized industrial part), print it, and return to this topic. 
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3. Put the printed copy under the camera. With a 16 mm lens, the worfang distance is about one foot. 

4. You control In-Sight with an 8-button Control Pad . Start by clicking its Abutton. In-Sight opens the 
System menu, used to select high-level options: 



Toggle live mode 

Continuous, External, or Manual 

Serial and Discrete I/O 

Save or load jobs or images 

Password locking 

Analyze performance 

System options 

Software information 

Toggle customized interface 


The X and O buttons also open important menus, used to build fonnulas and edit the worksheet. 

5. To interactively adjust lens focus and ^>erture, cursor Up or Down in the System n>enu and select 
Live. Click X, placing In-Sight in live mode, where it passes a stream of images through to the 
di^Iay, a bit like a motion picture camera. 

6. Adjust the camera and lens to obtain a clear, focused image with the part oriented horizontally, as 
shown below. 



7. When satisfied with the image, clickA to return to the System menu. Click A again to return to the 
worksheet. In general, the A button accepts changes and returns to the previous level. When you exit 
live mode, In-Sight displays the last acquired image. 
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You can snap a new image at any time by holding dovwi the □ button and simuJtaneousIy clicking X— 
a useful shortcut during development A typical deployed application instead acquires an image when 
it receives an external trigger signal. In-Sight consequendy offers configurable serial and discrete I/O 
interfoces for connecting external trigger sources and other devices. 

8. Continue to the next topic, where you build a model subsequently used to search for two holes. 


< Getting Started: Fixture the Part 

Manufacturing processes usually do not perfectly constrain the parts being inspected. To compensate for 
image-to-image variation in part location and orientation, many vision applications establish a fixture 
coordinate system^ which remains fixed with respect to each part, ehminating the image-to-image 
differences. To do so, the application fiist finds a "landmark" feature in each image. As much as practical, 
this feature must be something tiiat the application can find reliably in all situations it is likely to encounter.' 
Subsequent operations are defined by offsets from the fixture origin and depend on its reliablity. 



Hole B 


A common strategy is to find the fixture origin and angle through a preliminary feature extraction step. In this 
exercise, you use pattern matching to find the fixture origin and angle. The basic idea is to find two holes, 
calculate the mic^x>int and angle of the line connecting their centers, and adopt those values as a fixture. The 
steps are: 


1. Build a Model 

2. Find Two Holes 

3. Calculate the Origin 

4. Calculate the Angle . 


These sections introduce many fundamental In-Sight concepts. 
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^ A ► Getting Started: Build a Model 

Pattern matching is a model-based search technique. It compares a model — an example of the desired 
feature — to regions of an image to find regions that fit the model. In tfiis topic, you extract a nnxiel from the 
image. Along the way, you learn some important In-Sight techniques. 

^ To BuUd a Model of a Hole 


1. Move to cell Al. 

2. Chck and release die X button, opening the Fomfiula Builder dialog, used to create and edit fomiulas: 


Keypad 


Current 
cell 


Function Function 
categories list 



Selected 
function 


3. In the center pane, highlight Vision Processing and click Right, moving to the right pane. 

4. Click Down to highlight die Find heading, and then click X to expand it. 

5. Select the FindPattems() function (which extracts a model from an image) and click X, opening its 
property sheet: 



Many In-Sight functions have properly sheets, used to view and change their parameter values. 
6. Click Down to highlight the Region heading, which lists the parameters that define the region of 
interest (ROI) used as a model. By default, the Region heading is collapsed ( v). To view the 
individual parameters, e?q)and the heading by highlighting it, clicking and holding X, and selecting 
Expand from the Enter menu. The heading opens up when you release the X button: 
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9. 


10. 


11. 


Heading- 
Parameters^ 











m 










Summary 


values 


- „ ™. ^^^^ u^i^wjc^uvvijr, lu^iu^ii aiiy ivcgiuij pmcuiicicT, anu men cucK in uie resulting dialog 
box, click the Region button. In-Sight hides the woiksheet and draws an interactive cursor on the 
image. Repeatedly clicking O cycles through the cursor modes. One mode sets the region's postion, 
another its size, and another its angle: 


Position 


Size 


Angle 



Col 


Row 


e4 


247— Wide 


High 



Degrees CCW 


The arrows on the "top" and "left" sides point away from the origin, for operations aifected by the 
region's orientation. 

Using the Control Pad cursor, set the ROI position by dragging the Region cursor until the center of 
the ROI is at the center of Hole A. Next, click O to change the Region cursor to its resize mode. 
Resize the ROI to surround Hole A, clicking Up and Down to set the height and Right and Left to set 
the width. Exclude the background, like this: 



Click X to accept the ROI. In-Sigjit returns to the FindPattemsO property sheet. This kind of 
interactive, graphical selection for defining regions and other parameter values is a common 
convenience in the In-Sight interface. 

Click OK FindPattemsO extracts a model from the ROI and stores it in cell Al in a Patterns 
^^^^"'^ ^ In-Sight closes the FindPattemsO property sheet and returns to the worksheet, marking the 
structure with a ^ icon. Encapsulating complex image or feature data in a single cell by storing it in a 
structure is another characteristic feature of the In-Sight interface. 
Now that you've extracted a model, you're can use it to find Holes A and B , 
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^ A ► Getting Started: Find Two Holes 

In the previous topic, you extracted a model from the image. Now you're ready to search for the model in 
the image, using it to find Holes A and B. 

> To Search for Holes A and B 

1 . With cell Al still selected, note the graphic drawn on the image to indicate the model region. Now 
move to cell A2, immediately below the cell storing the Patterns stmcture. Because the relevant 
structure is no longer selected, the region graphic vanishes. Displaying a gr^hic appropriate to the 
selected structure or parameter is called flyover graphics. When you traverse ("fly over") the 
worksheet, you therefore see a context-sensitive indication of the underlying data. 

2. Leaving A2 empty, move to A3. Click Xto open the Fonnula Builder, move to the left pane, and 
open Find heading. 

3. Highli^t the FindPattems() function (which finds instances of a model in an image) and click X to 
open its property sheet. 

4. To specify the model built previously, you make a reference to the Patterns structure that stores it. To 
do so, highlight the Model parameter and click X. In-Sight hides the property sheet and shows the 
worksheet in interactive reference mode. As its name suggests, this view of the worksheet grid lets 
you define a cell reference graphically, through the Control Pad cursor. 

5. Click Up to move the highlighted cell, indicated by the marquee, to cell Al, which contains the 
Patterns structure: 


Image object 

(stores acquired image) ^ 

Pattern object 
(stores model data)' 

Reference 

from A2 to Al 
























ttafiget^f 






6. Click X to accept the reference. Any cell reference can be absolute (unchanged when copied) or 
relative (keeps a fixed offset, but not a fixed target, when copied). By default, this particular reference 
is absolute, so a copy of cell A2 uses the same model, stored in cell Al. 

7. Specify the search regiwi by highlighting the Region heading and clickingX. The interactive technique 
for setting the search ROI is the same as that for selecting the model ROl: 

a. I>rag the cursor center to the ROl center. 

b. Click O to change the cursor to its two-arrowed form, then resize to surround Holes A and B 
and exclude Holes C and D. In general, the size of an ROI depends on positional and angular 
uncertainty and other factors. For this exercise, allow some "padding" on all sides of the holes. 

c. Chck X when done to accept the ROl and return to the property sheet. 


The result should look about like this: 
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- Region cursor 
Region center 


8. Highligjrt the Number to Find parameter and click X to select it for editing. When you select a 
numeric value, cursor Up increments the value, Down decrements it, and Right and Left move ^'back 
and fbrtii" from digit to digit Increment Number to Find to 2, reflecting the number of holes expected 
in the ROI: 


9. 


10. 


11. 


Similariy decrease the Accept value to 20. An acceptance threshold is a the minimum score accepted 
as a valid instance. Reducing it makes the search more permissive, decreasing the risk of failing to find 
both holes during this exercise. After setting Accept, chck X 

In the property sheet, click OK, mnning the model. FindPattemsQ returns a Patterns stmcture, which 
contains a data about the instances of the model found in the image, to cell A2: 

Poses object 
(stores instances 
found in region) 

Indexes of the 
two instances 
found 


Search region 
Instance 0 

Each instance has an index and a set of measured values. Because the Patterns structure contains 
complex feature data, you can't access the data directly from a formula. To expose the individual 
values, In-Sight automaticaJJy emits formulas to enpty cells. Other formulas can then refer to these 
cells to obtain the individual values. 

At this point, you've obtained all the data you need to calculate the midpoint between the centers of 
the two holes, as described in the next topic . 



^ A ► Getting Started: Calculate the Origin 

In the previous topic, you found two holes through a pattern match search. The result was a Patterns 
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structure storing the instances found and a set of automatically generated cells containing data about them. In 
this topic, you use worksheet iimctions to calculate the midpoint, vMch will define the origin of the fixture 
coordinate system. 

^ To Calculate the Fixture Origin 

1 , Except for its automatic generation, an emitted formula is in every respect the same as any other 
formula. You can freely copy, edit, delete, or otherwise change any emitted formula. For this exercise, 
the only values you need are the row and column coordiiates of the two center points. To sin^lify the 
worksheet, delete the formulas that emit the Angle, Scak, and Scor« values: 

a. Move to cell El, which contains the string "Angle * used as a column label. 

b. Click and hold the O button, then click cursor Down and cursor Right to highlight the range 
fiomEltoG3: 


i 

^Patternl Index 

iRow 

ICot 1 

Arxjie Sc3ie Scor 

2 




O.G00 100.000 98 

3 




0.000 100.000 83 


c. Release O. In-Sight opens the Edit menu: 


Copy cells to clipboard 
Cut cells, copy to clipboard 
Paste cells from clipboard 
Remove cells, no copy to clipboard 
Open Formula Builder dialog 
Customize the worksheet 
Enable or disable cells 

Hide selected rows 
Unhide hidden rows 
Insert new row above 
Delete current row, shift up 
Set column width or row height 


d. Select Clear and click X. In-Sight removes the formulas from the selected cells. 
2. Next, calculate the row coordinate of the midpoint The formula required is (C2 + C3)/2, which you 
create as follows: 

a. Move to cell C4 and click Xto open the Formula Builder. 

b. Click cursor Right to enter the keypad area. There, move to the { button and click X. In-Sight 
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adds the ( c haract er to the formula line. 
Move to the 


c. Move to the (relative reference) button and click X. In-Sight hides the Fonnula Builder 
and shows the worksheet in interactive reference mode. Move the marquee to cell C2, which 
contains the row coordinate for Hole A, and clickX to accept the reference. 

d. Continue in the same fashion to construct the entire fbmiula, (C2 + C3)/2. 

e. When done, click OK. The fomiula returns its result — the average of the row values — to ceD 
C4. 

After calculating the row average, it's easy to calculate the column average: 
a. Hi^iiight cell C4, the row average. 
CUck O, yielding the Edit menu. 

Select Copy and click X In-Sight copies the formula to the clipboard. 
Highlight cell D4. 

Click O, select Paste fiom the Edit menu, aiul click X. In-Sigjit pastes the formula fiom the 
clipboard to cell D4: 


b. 
c. 
d. 
e. 


1 

^Patten 

Index 

Row 

Cd 

2 


:0J300 

201^ 

133,5K 

3 


1.000 

204.470 


4 



202.851 

u mm? I 


Because the references to the row values are both relative references, In-Si^t adjusts them to 
preserve equivalent offsets. Without any editing, the new formula in D4 is (D2 + D3)/2, which 
calculates the column average. The ability to copy a formula to a new cell and get a similar result is a 
major benefit of using a woiksheet interface for vision applications. 

4. Now that you've found the row and column av«ages, go on to the next topic to calculate the angle. 


^ A ► Getting Started: Calculate the Angle 

In the previous topic, you calculated a row and column value to serve as the origin of the fixture coordinate 
system. Here, you calculate the fixture angle, often called Theta to distinguish it fiom other angle values. 


^ To Calculate the Fixture Angle 


1 . Highlight ceil E4 and click Xto open the Formula Builder. 

2- From the Geometry category, open the Measure heading and select the PointToPointAn^e fiuiction, 
which returns the angle between the Y axis and the line defined by two points. ClickX to open its 
property sheet. 

3. Hi^ght the Point 0 heading and click X, placing the worksheet in interactive reference mode. 

4. Move the marquee to cell C2, click and hold O, and click cursor Right to select both C2 and D2, the 
row and column values for the center point of Hole A. 
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5. Click X. In-Sight defines Point 0 through the references to cells C2 and O and returns to the 
property sheet. 

6. Repeat the process for Point 1 : Highlight Point 1, click X, move the marquee to cell D2, select the 
range D2:D3 and click X. In-Sight defines the second point and returns to the property sheet. 

7. Click OK, closing the property sheet. Click OK again, closing the Fomiula Buildar. 
PointToPointAngle returns the angle value to cell E4: 


"F^intToPoint^igie(C2 jD2^^^^^ 



. A 

B . 

c 

.0 


- i 

0 






■ i 

1 

^Pattern 

Index 

Row 

Cd 



2 

^Poses 

0.000 


133^ 


i 

3 


IJJOO 

204.470 

503.648 



i 4" 



^^.851 

^318.607 

:'/ 89:499" 

t 

" 6 



0^BS^ 





Fixture X Fixture Y Fixture Angle 


8. Vision applications use a fixture coordinate system to eliminate image-to-tmage variation in part 
location and orientatioa To see this in action, try the following experiment: 

a. Click and release A to open the System menu. 

b. Select Triggers and click X^ opaiing the Triggers dialog: 


From Control Pad 
Automatic and continuous 
From hardware trigger 


c. Highlight Continuous and click X This enables continuous acquire^ which constantly iq>dates 
the image and the worksheet, a bit like a motion picture camera. You should see the woricsheet 
values continuously updating. 

d. Tap the printed image under the camera. The calculated fixture values should follow the image 
of the part. 

e. Assuming that small disruptions don't cause a problem, idy moving the image slightly. The 
amount of tolerance to change in location and angle depends on the exact size of your region of 
interest and other variations beyond the control of this exercise. 

f If you like, you can complete tiie rest of the exercise with continuous acquisition enabled (0). 
The discussion assumes that disable it (C^ by selecting Continuous, clicking X^ and then clicking 
A twice to return to the property sheet. 
9. Now that you've obtained a coordinate system that is constant within the part instead of the image, 
you*re ready to find a straight edge . 
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M A ► Getting Started: Find a Straight Edge 

In the previous topics, you used a pattern matching and some calculations to establish a fixture coordinate 
system. At that stage, the goal was to quickly locate the part in the image, not to make a final inspection. In 
the next group of topics, you find a straight edge and a curved edged, then measure the distance between 
thenx 


Curved edge 



Hole B 


► To Find a Straight Edge 


1- 
2. 


4. 

5. 
6. 
7. 


From cell A5, click X to open the Formula Builder. 

From the Vision Processing category, open the Edge heading, and then open the FindLine property 
sheet. FindLine, as the name suggests, uses feature extraction method called edge detection to detect 
straight lines. 

Highlight the Fixture heading and click X In-Sight shows the worksheet in interactive reference 
mode, so that you can create the references interactively. 

Highlight cell C4 (the fixture row), click and hold O, and then click Right to select cells C4, C5, and 
C6 (the fixture row, column, and angle). 

Click X to accept the references, returning to the FindLine property sheet 

Hi^ght the Region heading and clickX. In-Sight displays the Region cursor 

An edge is a black-to- white or white-to-black transition. When you define a region for edge 

detection, you have to consider the edge's polarity, which is the expected grayscale transition. 

In-Sight evaluates polarity along the Region's X axis, progressing away fix>m the origin: 


Region origin^ 


Scan direction 



^Detected edge (black4o-white) 


The bottom edge of the part image is horizontal. Viewed fix>m background-to-foreground (bottom-to- 
top in the image), the edge is white-to-black. To detect this edge, you must rotate the region by 90 
degrees, so that its X axis is peipendicular to the edge: 

1 . With the cursor in its four-arrow fonii, move the region until its center reaches bottom edge. 

2. Click O to change the cursor to its two-arrow form, then reduce the width and increase the 


I MSDOCrD:<WO 0111445A2_L> 


Appendix I - Page 42 


wo 01/11445 


PCTAUSOO/22383 


height 

3. Click O to change the cursor to its circular fonn, which rotates the region. Click and hold Left 
to rotate the region by 90 degrees. The result should look about like this (with the edge 
strength-graph removed for clarity): 


4 . Click X to return to the property sheet. 
Highlight Polarity and click X to show its list of values: 


10' 

Poferity 


11 

FimJ By " 


12 

Acc^t Thre^sh " 



Select "white-to-black" and click X to accept. 
9. Click OK. FindLine detects the edge and stores an Edges structure. It also emits a row and column 
for both end points as well as a score: 


Edges array 
(stores delected 
edges) 


! ■ 



■:. 

" D > 

r E •■ " ^■ 











iJ. . 

^Pattern 

Index, - 

Row ^_ , 

Col:. 





SbPoses 

■ 0J300 

. .188^ 

122^ 




i 3. 


. ynoo 

.188^: 

484.044 




! .4 





- 895^ 



T"5-^ SiEdqes 




mmm 




Endpoint^ 


Endpoint^ 


Score 


1 0. FindLine, like other Edge functions, also draws and edge-strength graph, best viewed by clicking A to 
hide the woricsheet: 
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1 1 . Now that you've located a straight relative to the fixture, you're ready to locate a curved eda^ 


^ A ► Getting Started: Find a Curved Edge 

In the previous topic, you found a straight edge. Here, you use similar techniques to find a curved edge. 
► To Find a Curved Edge 

1 . From cell A6, click X to open the Formula Builder. From Vision Processing, open the Edge, and th«i 
open the FindCurve property sheet. FindCurve, as the name suggests, uses edge detection to detect 
curved lines. 

2. As before, highlight Fixture, click Xto enter interactive reference mode, highlight ceil C4, click and 
hold O, and click Right to select cells C4, C5, and C6. When done, release Q and then click Xto 
accept the Fixture references, returning to the FindCurve property sheet 

Highlight the Region heading and clickX. In-Sight displays the Region cursor. The adjustments are 
similar to those in the previous step: 


3. 


1. 


3. 


With the cursor in its four-arrow fomi, place the center of the cursor on the desired edge. 
Click O, then reduce the height and width. 

Click O twice to change the cursor to its curve form. Click and hold Up to waip the region by 
100 degrees. The result should look about like this: 


4. Click X to return to the property sheet. 

4. Highlight Polarity, click X to show its hst of values, select "white-to-black", and click X to accept. 

5. Click OK. FindCurve detects the curved edge, stores an Edges structure, plots an edge-strength 
graph, and emits various values: 


Endpoint Midpoint Endpoint Radius Score 

6, Now that you Ve located two edges, you're ready to measure tlie distance bet\\^een them . 


COGIMEX 


Appendix I - Page 44 

MSDOCID: <WO 0111445A2_L> 


wo 01/11445 


PCT/USOO/22383 


^ A ► Getting Started: Measure a Distance 

At this point, you have found a straiglit edge and found a cun^ed edt;e . Now you can measure the distances 
between them, representing an inspection step in an application. 

^ To Measure an £dge-to-£dge Distance 


1. 

2. 
3. 
4. 

5. 
6. 


9. 


From cell A7, click Xto open the Formula Builder. 

From Geometry, open the Measure heading. 

Select the IJneToCircIe function and open its property sheet. 

Select the Line parameter, click Xto enter interactive reference mode, move to cell B5, hold down 
the O button, and select the range B5:E5 (both end points of the bottom line). 
Release O, and then click X to accept the references, returning to the property sheet. 
??Se!ect the Circle parameter, expand it, select the Row parameter, click Xto enter interactive 
reference mode, move to cell B6, and click X to accept, returning to the property sheet. 
?Select the Column parameter, click X; move to ceD C6, and click Xto accept, returning to the 
property sheet. 

?Select die Radius parameter, click X; move to cell H6, and click X to accept, returning to the 
property sheet. 

Click OK to close the property sheet LineToCircleQ 

returns the shortest distance, in pixels, fiiom straight edge to the curved edge: 



Many inspection applications obtain distances like the one just measured to confirm that a part fits its sp 
In-Sight includes a wide selection of functions (arithmetic, logic, trigonometry, statistics, range 
checking, conditionals, and so on) for processing values in formulas. 

1 0. Repeat this sequence of steps to measure the other center-to-center distances. 

11. Go on to the next step, to find the leads . 
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^ A ► Getting Started: Save the Job 

By now, you're ready to save the job. 
Curved edge - 

Straight edge < 


► To Save the Job 

1 . Click and release A, opening the System menu, 

2. Select Files and click X, opening the Files menir 



Opens Save and Load Job dialog 
Opens Send and Receive Image dialog 
Opens Send and Receive Settings dialog 
Create a new job 


3. Select Job, opening the Save and Load Job dialog: 
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^ A ► Control Pad: Working With 

You operate and configure In-Sight witfi an 8-button Control Pad, not with a keyboard or a mouse. This 
aspect of In-Si^t's interface reflects its design for the factory floor, which often does not have a desk or 
other surface suitable for a keyboard. For In-Sigjit, the Control Pad is better than a keyboard, since an 
opoBtor can use it v^liile standing, moving, wearing gloves, and so on. A Control Pad can hang from the 
ceiling, and its sinphcity improves robustness. 

This section describes how to use the Control Pad, discussing these topics: 

• Button Usage 

• Button Menus 

• Entering Digits 

• Entering Text 

• Editing Text 

The Control Pad is required for development but optional for deployment. When the system is nmning as a 
freestanding device, without the Control Pad, it relies purely on externa! triggers. 

hi-Sight automatically calibrates the attached Control Pad on power up. To calibrate it manually, 
simultaneously press the X, □, A, and O buttons. 

To trigger image acquisition from the Control Pad, see Manualh TriL^ffenmr an Acquire . 



^ A ► Control Pad: Button Usage 



The In-Si^t Control Pad has a directional cursor and four input buttons. General conventions are: 

• The cursor buttons — ^Up, Down, Right, and Left — are the navigational controls: 

o They provide two-dimensional movement in the worksheet, menus, dialog boxes, and property 
sheets. For example. Up and Down move along worksheet columns, and Right and Left move 
along worksheet rows. If a direction is unavailable, its button does nothing- 


Appendix I - Page 48 


wo 01/11445 


PCT/USOO/22383 


o When editing a digit. Up increments and Down decrements; and Right and Left move "back 

and forth" fix)m digit to digit 
o When resizing a region of interest. Up and Down set the height, and Left and Right set the 

width. 

o Holding O, Up selects an enter column. Right selects and entire row, and Down and Right 
select a cell range. 

• The X (Enter) button enters, accepts, and "drills down" hierarchically: 

o Clicked and held on a cell, it opens the Enter mcniju used to enter worksheet values, formulas, 
and references. 

o Clicked and released on a cell, it opens Fomfiula Builder dialog, used to construct expressions. 

(This shortcut simply accepts the default from the Enter menu.) 
o In a menu, property sheet, or dialog, it selects an option. 

• The A (System or Escape) button exits, cancels, and Open quote "drills up*' hierarchically: 

o From a cell, it opens the System mcniu used to select high-level options, 
o It closes the cunent dialog or property sheet, ?canceling? any change in its settings. (In read- 
only contexts, X and A are equivalent.) 
o Repeatedly clicking A eventually returns to the top level. 

• The □ (Image) button: 

o From the worksheet or a property sheet, it shows the image by itself, hiding the worksheet or 

property sheet. Click again to return, 
o To issue a trigger, hold down Dand then click X By default, the trigger acquires a new image, 

but you can change its bdiavior 
o To toggle continuous trigger, hold down □ and then hold down X 
o Clicked v^en when editing a fomiula or text string, it is a shortcut for back^ce. 

• The O (Edit) button: 

o Clicked on a cell, it opens the Edit menu, A^iich contains operations that help you manage the 
worksheet. 

o Clicked and held on a cell, it selects a range of cells in conjunction with the Control Pad cursor, 
o In the Text Entry dialog, toggles between uppercase and lowercase. 



^ A ► Control Pad: Button Menus 
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Profiler 


Custornize 


nize. ' ." J 


1^ Versjpn ^^-. ^Ij 


Absoiurir 


Forrnuta f 
Prop^tieij 


Hide Cots " 
iQnNde^Col^ 


Three of the four Control Pad buttons open important menus. In each menu, In-Sight highlit the current 
item and highlights (optionally, flashes) its name. Selecting an itan and clicking X yields a menu or dialog box 
where you select or change values through text fields and option buttons. You are always free to switch to 
any menu to view or change its attributes. 

Clicking X opens the current item, letting you view and change its options. For example, clicking Xat 
Trigger opens the Trigger dialog. After opening a menu, cursor Up and Down navigate within the menu, and 
X opens or toggles the selected item. Clicking A "drills up" one level, ultimately returning to the top level 



^ A ► Control Pad: Entering Digits 

You can directly enter numeric values in dialog boxes, property sheets, or worfcsheet cells using the Control 
Pad cursor. After selecting a cell, parameter, or option, you increment or decrement each digit with cursor 
Up or Down, and you move from digit to digit with cursor Right or Left. For worksheet cells, an alternative 
method is to aiter numeric values through the Fomiula Builder . 

^ To Edit a Numeric Value 


1 . Select a ceU, numeric parameter, or numeric field: 

o From a dialog box or property sheet, highlight a numeric parameter or field, and click X 
o From a worksheet cell alreadjy containing a numeric value, click X. 

o From an empty worksheet cell, click and holdX to open the Enter dialog, select Value, and 
release X. 

L>Sight selects the numeric field and highlights the current digit: 
Selected digit 
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3. 


To increment the current digit, click cursor Up; to decrement it, click cursor Down. 

NOTE When you increment a digit above 9, it canies over to the next 10. For example, if the value 
is 18 and you select the "8," then clicking Up yields the series 19, 20, and 21. Decrementing 
yields similar behavior, as in the series 2 1 , 20, and 1 9. Decrementing a positive number 
below 0 yields a negative number, and vice versa. 

To move fiom digit to digit — say, from the "10s" space to the "100s" space-^lick cursor Right or 

Left. In-Sight highlights the selected space: 


iEa3:sLil lisictisjal i^^sM ligiMi 


4. When satisfied with the value, release X to accept it. 


^ A ► Control Pad: Entering Text 


You enter free-form text in dialog boxes and worksheet cells through the Text Entry dialog, which you use to 
build a name. 
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The dialog has two keypad-like areas. On the left, you enter the letters of the alphabet; on the right, you 
enter digits, punctuation, and special characters. To toggle between the uppercase and lowercase letters and 
characters, click O. 


At the top of the dialog, you can see the string under construction. The insertion point, I , marics the current 
position for insertion or deletion. 
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The dialog has the following options: • 

Caps Lock Uppercase alphabet and special characters when "on"; lowercase when "off." Also shifts the 
set special characters. Shortcut: click the O button on the Control Pad. 

Auto Center cursor jumps to the center position (M or 5) after each character. When "off/* 

the cursor stays at the last position after each character. 

The Caps Lock option (or its O-button shortcut) toggles between the uppercase and lowercase alphabet; it 
also changes the set of special characters 

Selecting characters from a two-dimensional table for cursor selection is fester than rolling through the entire 
alphabet for every field To encourage the use of motor memory, the cursor by default jun^s back to the 
middle position (M or 5) whenever you click OK or reach the perimeter. The click path to each letter is 
therefore constant No letter (excq^t is ever more than two clicks away (using diagonals) or four clicks 
away (ignoring diagonals). This text selection method rapidly becomes second nature. 

NOTE The Text Entry dialog builds names, not worksheet expressions. Its mathematical symbols are text, 
not operators. For example, the sequence "1+1" is a string, not an expression that evaluates to "2." 

= == — =— =— — =— CCDGIMEX Insight; 


^ A ► Control Pad: Editing Text 

This topic describes how to edit a text string in the text entry dialog. 
► To Edit a Text String 

1 , Fro m a fie ld that accepts text, click X to open the Text Entry dialog. (Or, from the Formula Builder, 


click ra.) 

2. Using the Control Pad cursor, move to a letter, digit, or character. 

3 . Click X. hi-Sight adds the letter to the string displayed at the top of the dialog. By default, the text 
cursor junips back to the center position, either M or 5. 

4. To insert a character inside an existing string, click cursor Up until you reach the string. Next, click 
Right or Left to move the insertion within the string. Widi the insertion point in the desired location, 
click I>own, move to the character to insert, and click X. In-Sight adds the new character at the 
insertion point, between the previous characters. 

5. To delete a character, click Up until you reach the string. Next, click Right or Left to move the 
insertion point in front of th e character to de lete. Click the □button. (Alternatively, click Down to 


enter the keypad, then click efej^^d.) In-Sight deletes the preceding character 
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Before 



— Insertion point 

! Save Job Asi. jyh^ZlSfTing ' 



|j -Save Job Asfhif^Strtng ' - 



6. When done with the string, click A. In-Sight pastes the string into the field and closes the Text Entry 
dialog. 
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^ A ► GUI: Using the In-Sight Interface 

You run In-Sight using a graphical user interface (GUI) similar to the interfaces iamihar from peisonal 
computers. The In-Si^t GUI offers menus, dialogs, property sheets^ option buttons, text fields, and other 
femiliar devices. The most important part of the In-Si^t GUI the worksheet, a rectangular array of cells 
ananged by row and column. A key difference between In-Si^ and a personal conputer is its use of a 
Control Pad in lieu of a mouse and keyboard, reflecting practical requirements on the factory floor. 

This section introduces you to In-Sight' s user interface, discus:»ing its major components: 

• Worksheet 

• Formula Builder 

• Formula Builder Buttons 

• Property Sheet 

• Using a Property Sheet 

• FIvoyer Graphics 

• Understanding Structures 

• Table of Structures 

• Emitted Fomiulas . 

The In-Sight interface displays the worksheet and image at the same time by a semi-transparent overlay. 
Viewing the image and the worksheet together eliminates the need to alternate between the two views — a 
major convenience when setting up a worksheet based on the features in an image. 

When done with this section, you should be ready to go to Using the Worksheet, which describes how to 
manipulate cells, rows, and columns. 


^ A ► GUI: Worksheet 

The most important part of the In-Si^t int^fece is the worksheet . As shown below, a worksheet is a table 
o f cells , with the rov^ identified by a digit (0 through 999) and the columns identified by a letter (A through 
Z). You refer to a cell through its row-column address. For example, the top-left cell is AO, where In-Si^ 
stores the acquired image. 


hnage structure, 
stores acquired- 
image 


Currenl cell 


Worksheet columns 
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Initially, the worksheet is blank (except for a few cells in row 0. which store the acquired image and other 
crucial data). Each cell can contain a fonnula. which is an expression that evaluates to a value. To create a 
madiine vision application, you put fonnulas into cells by means of the Control Pad . 

At a given time, the focus of the worksheet is on one cell. Moving around the worksheet with the Control 
Pad changes the cell that has focus. In-Sight indicates the current cell by highlighting it in inveree video and 
by printing its row-column address in the Formula Bar at the top of the worksheet: 

Curreni cell (Row, Column) 

r — ^ - • ^ "• • ~ / '^ ^ 

Current formula Insertion point 

The Formula Bar also shows the current formula. 

In-Sight displays the worksheet and the image at the same time by a semi-transparent overlay . This feature 
lets you view the image and the worksheet together, eliminating the need to alternate between the two 
views — a major convenience when setting vp a worksheet based on the feature in an image. 


^ A ► GUI: Formula Builder Dialog 

When you click a cell (or select Formula from either the Enter or Edit menus), In-Sight opens the Formula 
Builder dialog, which you use to put expressions into woiksheet cells: 


Keypad 

Opens 
Text Entry 
dialog 


Absolute 
cell reference 

Relative 

cell reference 



Vision Processinq 


m 
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Help text 



To expand a collapsed heading (marked v), select it and click the X button; to collapse an expanded 
heading (maiked^), select it an click X. In-Sigjit shows or hides the contaits of the heading. 

Selecting a function fiom the function list opens, that function's property sheet, tfiough which you set its 
values. (Some functions don't have property sheets. Pi, for example, doesn't have any parameters, so it 
doesn*t have a property sheet) For details about using the Formula Builder, see Enterimj a Formula , 


^ A ► GUI: Formula Builder Buttons 


Edits a $ character in a formula, 
to change a relative reference to 
an absolute reference, ""---^ 


Opens the 

Text Entry dialog 


Destructive 
back space 


Creates an absolute cell reference 
Alternative: select Absolute from 
the Enter menu. 

Creates a relative cell reference 
Alternative: select Relative from 
Ihe Enter menu. 

Parenthesis operators, which control 
the order of evaluation. All functions 
require a terminal closing parenthesis 

Closes the Formula Builder, 
transferring the formula to the v\/orksheet 



Arithmetical 
operators. 


Decimal 
point. 


Closes the Formula Builder, 
erasing the formula. 


^ A ► GUI: Property Sheet Dialog 


You set parameters values through a property sheets opened when you select the function from the Fonnula 
Builder. 
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B(tractSi^tEfeib^Iif§^^^ V 
Extr^ts~bk)bs from an Image and sorts ih^nonelstep. 
Returns a Blob& structured ^ rf;"^: 


R^n^once^to test. current values^: 
without^closing " 


To select the value you want to change, use the Control Pad cursor to move up and down the input list The 
flyover graphics and help text both change to reflect the current parameter. 

The triangle icons indicate items with more than one parameter. Clicking the triangle opens the item to show 
all of its parameters. 

If a cell contains a function, you can open the property sheet from the cell by moving to the cell, clicking X, 
and selecting Properties finom the Enter menu. 


^ A ► GUI: Using a Property Sheet 

The property sheet use icons to indicate types of inputs and relationships among them. 
Headings 
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Headings collect related values. 
To expand a collapsed heading ( 

select it and click the X 
button; to collapse an expanded 
heading (^), select it an click X. 


^f226^5f^99t5,fl3,243.0) 








m 



m 



m 



ml 




Collapsed 
Expanded 


Toggles 

Toggles arc input values that 
have two states, ON (EI) or 
OFF (D). To change between 
ON and OFF, select the toggle 
and click X. 


1 113 1 Inckjde^Hotes - 


I ma IndiKte ^Hdes^^ ? IIP" 


On 


^ Off 


Lists 


Lists, marked are input values 
that have several named values. 
To expand or contract a list, 
click X. 









";:either ',i 1 1 r^, 

1- I 


Collapsed 
Expanded 


^ A ► GUI: Flyover Graphics 


In-Sight shows the worksheet or property sheet and die image simultaneously — a major convenience when 
developing a vision application. It also overlays relevant graphics on the image. For example, the following 
image shows a property sheet, an image, and graphics indicating the region of interest and the features 
extracted from the image: 



^ Image and worksheet 
displayed together 

Region graphic 
• Ejdracted blobs 
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t 

^ In-Sight always displays the graphics associated with the current cell or property sheet. By default, moving 

i off a cell removes its graphics. When you traverse ("fly over*') the worksheet, you therefore see a context- 

l sensitive indication of relevant data. For example, when you highlight a cell containing a Blobs structure, 

I In-Sight draws the blob outlines on the image. When you move away from the Blobs stmcture, the blob 

I outlines vanish. 

If you want the graphics to persist when you move off its cell, you can set the associated function's Show 
parameter to enable input graphics, result graphics, or both. 


NOTE Sometimes the worksheet grid can hide lines or points that happen to fall exactly under a grid line. 
The image is the bottom layer, the flyover graphics are the middle layer, and the worksheet is the 
top layer. 



^ A ► GUI: Show Graphics Option 

When you highlight a cell containing an structure, In-Sight displays the associated flyover graphics. By 
default, these graphics vanish when you move to a new cell, reducing visual clutter. If you want them to 
persist, you can enable them through the associated function's Show Graphics parameter, available for 
functioTis that return a stmcture. 


For the persistant graphics, In-Sight distinguishes between input graphics (which show the fiinction's 
parameters), result graphics (which show a measured value or other result); and charts (wfech plot a 
histogram, score, or other value). For example, PointToCircleQ has input graphics for the point and circle, a 
result graphic for the distance, and no chart: 


Input (circle) 
Input (point) 


Result (distance) 



To control the persistant gr^hics, the Show Graphics parameter offers these options: 


hide all 

result graphics only 
input and result graphics 
show all 


Disables all graphics, wiiidi arc visible only when you "fly over** the 
associated cell. The default. 
Enables only the result graphics. 
Enables both input and result graphics. 
Displays all input, result, and chart graphics. 
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^ A ► GUI: Understanding Structures 

In-Sight stores multi-dimensional image or feature data in structures. For example, it stores the acquired 
image in a structure called Image that resides in cell AO. Functions that depend on the acquired image refer 
to cell AO to obtain the image stored there. Functions that produce a new image— for example, as the result 
of an image processing operation — create a new, additional Image structure to store the result image. 

Many vision functions store results in various stmctures, each marked with an Qi icon in the worksheet 
FindPattemsO, for example extracts a model from an image and stores it in a structure called Patterns. 
FindPattems() subsequently refers to the Patterns structure to obtain the model, searches an image for 
instances of the model, and stores its results in a structure called Patterns. Internally, tfie Patterns structure is 
a database of the instances found in the image, each described by a set of values such as its index, center 
row, center column, angle, scale, score, and so on. 


Poses object 
(stores instances 
found in region) 

Indexes of the 
two instances 
found 

Search region ^ 
Instance 0- 


c . 



Scafe' 


-Labels I 


I 


U Lijli Kfr7^iiKg 'V> J frpTif MlMTtVil gTrjMjj Mgffff, 


(if^r oi iv ^ 



A structure always resides by itself in a worksheet ceil. You cannot put a structure diiectiy in a formula 
because a stmcture is a container for complex data. The mathematical operations used to build formulas 
don't apply to stmctures. For example, a formula like "sqrt(Pattems)" doesn't make sense because a 
Patterns structure does not have a meaningful square root. 

To process a value stored in a stmcture, you must first extract the individual vahie. To simpliiy this process, 
many functions that produce stmctures automatically emit cells containing individual results. You can then 
build formulas that refer to these cells or delete any unneeded cells. 


For example, suppose you want to average the score values of the first three instances stored in a Patterns 
stmcture. Each instance has an index, starting with index 0. You therefore build a formula that refers to the 
score result for instance 0, 1, and, 2, sums them, and divides the sum by three. 

The emitted results are read from the associated stmctures through Data Access functions. If you prefer, you 
can call these underlying functions directly. 



^ A ► GUI: Structures 
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Structure 

Blobs 
Calib 

Circle 
Cross 
Delay 
Dist 

DNData 

Edges 

Fixture 

Hist 

Image 

Line 

Point 

Patterns 

Region 


Stores 

Blobs database. Each blob has an index and a set of measured values. 

Coordinate transformation, generated by Calibrate and subsequently used as a source of 

calibration data. 

Fixtured circle. 

Fixtured cross marie 

Buffer, generated by DelavLine . 

Line segment defined by its end points, length, and an angle (from the image row axis, by 
default). 

Stores DeviceNet data. Created by the DeviceNetRead function. 

Edges detected in an image. Each edge has an index and a set of measured values. 

Fixture row, column, and angle. 

Histogram and histogram statistics. Generated by ExtractHistogram . 

An image. The acquired image is always in cell $A$0. Other images — say, from 

NeighborFilter. PixelFilten or Warplmage — can reside elsewhere. 

Fixtured line. 

Fixtured point 

Stores an area or edge model and the results of a pattern-match search. Each instance 
found has an index and a set of measured values. 
Fixtured region. 


^ A ► GUI: Emitted Formulas 


Many fiinctions that return an structure automatically «nit one or more fomiulas at creation, eliminating the 
need to create a new formula by hand for each individual result: 

Poses object 
(stores instances 
found in region) 

Indexes of the 
two instances 
found 


Search region 
instance 0 

Each emitted formula calls a data access fimction to retum one of the values in the structure. Other formulas 
can refer to the emitted values as data sources. The function insals its emitted cells in adjacent empty cells, 
inserting new rows if necessary. 

Except for its automatic generation, an emitted formula is in every respect the same as any other formula. 
You can freely copy, edit, delete, or otherwise change any emitted formula. The reference to the underlying 
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structure is always an absolute reference . If you copy an emitted formula, the copy therefore keeps the same 
data source. 

Many structures store an indexed list of items. The corresponding emitted fomiulas occupy a block of cells. 
Each row is a set of values describing one of the indexed items. Each column is a particular data value — a 
row, column, angle, scale, or other result. 

Some stmctures store additional values beyond those automatically emitted. The emitted results are siinply 
those thou^t generally useful. To manually access additional results, you can manually create a new formula 
with the desired "getter " fimcdoa 

NOTE h>Sight prints a descriptive label above each emitted value when the worksheet row above the 

fimction is unocci^ied If the row already contains a formula, In-Sight omits the descriptions. To see 
the descriptions, leave an empty row for them. You can edit the descriptions as strings. 
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^ A ► Modes: Online and Offline 

t In on/ine mode, In-Sight responds to discrete and serial I/O, allowing it to communicate with 

\ other equipment in a production application. Online mode therefore represents "^normal" 

\ operation in a deployed application. Offline mode, in contrast, disables all I/O, isolating In-Sight 

[• from other equipment. 

\ 

% Vou change the mode with a toggle in the System menu. In-Sight indicates the current 

\ operating mode in the top-right corner: 


> To Change Operating Modes 

I 1. Click and release the A button, opening the System menu . 

[ 2. Select Online and then click X. In-Sight toggles from online mode to offline mode or vice- 

\ versa, indicating the current mode in the top-right comer of the worksheet. 

\ 3. Click A to close the System menu. 
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^ A ^ Modes: Secure, Operator, Program 
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^ A ► Jobs: Working With 


A Job is an executable configuration, like a software program, that contains a worksheet, all of its formulas, 
and other values. After you set up In-Si^t to solve a problem, you can name and save the current job ftom 
program memory to non-volatile flash memory, which acts like a solid-state hard drive for for storing jobs. 
You can subsequently load the job from its slot in flash memory to program memory for execution. 

This section describes how to work with jobs, discussing the following topics: 

• Saving and Naming a Job 

• Loading or Copying a Job 

• Creating a New Job 

• Selecting tlie Startup Job 

• Archiving Jobs . 

NO! E A job preserves only the worksheet and certain other values. It does not record the current image 
or the global options for defaults, passwords, I/O, and so on. Settings that affect all jobs are not 
saved with individual jobs. Instead, they are saved individually whenever changed. 


A ► Jobs: Saving, Naming, Deleting 

Saving a job writes the current job from program memory to a specified slot in flash memory, preserving any 
changes applied after the last save. Saving a job captures the current worksheet and all of its expressions, 
but not the current image or global options such as the password. When you save a job, you can supply a 
name, subsequently used to load the job. 

^ To Save a Job 


1 . Click and release the A button, opening the System menu . 

2. Select Files and then click X, opening tiie Files m^a 

3. Select Job and click X, opening the Save and Load Job dialog. 
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As inplied by the dialog's tabular organization, each job slot in flash memory has an index, 0 through 
15, and an optional name. 

4. In the dialog, highlight a job slot using the Control Pad cursor. 

o To save the job without a name, click ^ In-Sight names the job "Unnamed" and saves it to 
flash memory. 

o To name and save the job, click X In-Sight operis the Text Entry dialog, which you use to 
build a name as described in Entering Text When done, click OK, accepting the name. In the 
Save Job dialog, click A to save the named job. 

?If you attempt to save a job to a slot that already has a job, In-Sight issues an Are You Sure 
warning? 

NOTE The user-assigned name, up to ?16 characters long, is just a comment, not an alias used in 
other contexts. 



< A ^ Jobs: Loading or Copying 

Loading a job copies a named job from flash memory to program memory for execution. ?CurrentIy cannot 
load multiple jobs? 

^ To Load a Job 

1 . Click and release the A button, opening the Svstem menu. 

2. Select Files and then click X, opening the Files menu. 

3. Select Job and click X, opening the Save and Load Job dialog. 
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Each job slot in flash memory has an index, 0 through 15, and an optional name. 

4. Select the job to load, and then click X In-Sight loads the job from flash memory to program 
memory. ?Do you get a warning about overwriting an unsaved job? 

To duplicate a job, load it from one job slot and save it to a second job slot. 


^ A ► Jobs: Creating a New Job 

Creating a job initializes a new, imnamed job, erasing any existing job after confirmation. 
► To Create a New Job 

1 . Click and release the A button, opening the Svstan menit 

2. Select Files, opening the Files meniL 

3. Select New Job and then clickX, opening the New Job dialog: 


4. Click OK to create a new job or Cancel to cancel. 
Alternatively, chck New Job in the Save and Load Job dialog. 


^ A ► Jobs: Setting the Startup Job 

On power up, In-Sight inunediately starts executing the job that was running when it shut down. ??can you 
specify a default job?? 

Discuss new autostart dialog 

currently, starts up with job active at shutdown??-talk to Nick 
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You can also change the job over the serial port, as described in ?? 


cxsGisiex 



A ► Jobs: Archiving 


To make an archive copy of a job, as a safety archive or for In-Sight-to-In-Si^t transfer, the In-Sight can 
copy ?the entire contents of flash memory? to a hard drive on a remote computer via its RS-232 port. 

► To Archive Jobs to a remote PC 

1 . ?Hook up the PC to the serial port as described in XXX. 

2. ?Start up the archive program. 

3. From the XX dialog, specify a name for the new archive file. 

4. Click Archive. TThe archive program copies the entire contents of flash memory to the host PC? ? 
Could you archive individual jot«? 

5. When done, disconnect the PC from the serial port. 

^ To Archived Jobs from PC to Flash Memory 

1 . ?Hook up the PC to the serial port 

2. ?Start up the archive program. 

3. From the XX dialog, specify the name of the archive file to load 

4. Click Load The archive program copies ?the entire contents archive file to the. 

5 . When done, disconnect the PC firom the serial port 

To transfer a job from one hi-Sight to another, use an archive file 


COGIMEX 
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^ A ► Images: Working With 


Obtaining an image is a fundamental step for any machine vision plication. In-Sight therefore offers several 
ways to trigger an acquisition. 

• Manually Triggering an Acquire (Contro! Pa d) 

• Viewing a Live Image 

• Enabling a Triuger 

• Saving or Loading Images . 

You typically use manual or live acquisition during development You typically used triggered acquisition in 
the dq>loyed application. 

Common image problans include: 

• If the image is too light or dark, adjust the aperture ring on the lens. If Ml apemire yields insufficient 
brightness or depth of field, increase the light level as described in TBD. 

• If the image is blurry or uniformly gray, focus the lens. Alternatively, reposition the camera until you 
get a sharp image. 

• You typically get the best image (and the best lighting response) by placing the camera exactly 
perpendicular to the subject, particularly if the depth-of-field is ^lallow. 

• Many feature extraction operations dq>end on a minimum feature size. If the feature of inters is too 
small, reduce the camera-to-subject distance, increase the focal length of the lens, or both. 


^ A ► Images: Manual Trigger 


In-Sight acquires a new image and starts running the current job whenever it receives a trigger signal. Several 
trigger sources are available including the Control Pad, which you typically use during development as a 
convenient way to grab an image. ??Altemative: use dialog Manual option 

► To Trigger an Acquire from the Control Pad 
1 - Hold down the □ button. 

2. Click the X button. In-Sight immediately acquires an image, for example as shown below: 


Image structure, 
stores acquired- 
image 


Current eel 


Worksheet columns 
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Other methods for acquiring an image are live mode, continous acquire, and external triggers, as described in 
Working with images . 



^ A ► Images: Viewing a Live Image 

In-Sight offers a live mode^ which passes the image directly to the display, a bit like a motion picture 
camera. You typically use live mode when adjusting the lens, since it offers immediate feedback. In live 
mode, hvSight suspends the worksheet, updating it only once at exit With continuous acquisition^ in 
contrast, In-Sight constantly iqxiates the image and the worksheet 

► To View a Live Image 

1 . Click and release the A button, opening the System meniL 

2. Select Live. In-Sight enters live mode, passing the image to the display. 

3. If the image is too light or dark adjust the aperture on the lens. If the image is blurry or totally gray, 
adjust the focus ring. If the subject is outside the field-of-view, adjust the position of the subject and 
camera until the features of interest are visible in the image. 

4. When done, click any button, exiting live mode and returning to the worksheet At exit, In-Sight 
acquires the last image and updates the worksheet. 



^ A ► Images: Enabling a Trigger 

An external trigger is a hardware signal that causes the camera to acquire an image. In an inspection 
application, for example, a sensor might detect that a part is in position for in^^jection an issue a trigger. Most 
deployed applications rely on external triggers. This section describes how to set up the software to expect 
an external trigger. 

► To Enable an External Trigger 
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1 . Click and release A, opening the System menu . 

2. Select ? ? and then click X In-Sight displays the Triggers dialog: 


From Control Pad 
Automatic and continuous 
From hardware trigger 


3. XXXX. 

???Steve O requests a section showing how to set an acquire triggered from serial or discrete I/O. It 
would discusss: 

1. Receiving a trigger from serial or discrete I/O 

2. Processing the input message 

3. As a result of that processing, enable or disable the AcQuirehnage structure ($A$0), which results in a 
HW signal going to the camoa and thus an image. 



^ A ► Images: Saving or Loading 

If you have a serial connection to a remote PC, you can save or load an image. 
► To Save an Image 

1 . Click and release A opening the System menu . 

2. Select Image and then cHck X opening tfie Send and Receive Image dialog. 
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^ A ► Worksheet: Using 


In-Sight's worksheet intCTface greatly simphfies the task of developing and maintaining machine vision 
applications because it takes advantage of skills already familiar to many developers. With In-Sight, you 
acquire an image to a worksheet cell and then refer to the cell to apply built-in image processing and feature 
extraction functions. The results are simple scalar values that you can manipulate with conventional 
spreadsheet functions. By hiding the complexity of the image data and the algorithms used to manipulate it, 
In-Sig^t makes practical vision processing a reality for the manufacturing engineer or technician. 

This section describes how to use the worksheet: 

• Selecting a Ceil or Cell Range 

• Selecting a Row or Column 

• Cutting. Copying, and Pasting Cells 

• Clearing Cells 

• Enabling or Disabling a Cell 

• Hiding or Unhiding Rows or Columns 

• Liserting or Removing a Row 

• Setting Row Height or Column Widtli 

• Customizing the Worksheet 


A ► Worksheet: Select a Cell or Cell Range 

You select a cell or range of ceDs before perfonning another worksheet operation, such as cutting or copying 
cells. To select entire rows and columns, see Selecting a Row or Column , 

> To Select a Single Cell 

1 . Using the Control Pad cursor, move to the desired cell, In-Sight highlights the cunrent cell and prints 
its row-and-column address in the Formula Bar: 







r A- ' 




f ot 










r2i 











2. Cut, copy, edit, or otherwise change the cell. 

► To Select a Cell Range 


> Current cell 
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Select 

entire 

column 


Select entire row 


Extend 

range 

right 


Extend range down 

1 . Move to the top-left cell in the desired range. 

2 . Hold down the O button. 

3. Move to the bottom-right ceil in the range by clicking cursor Right or Etown to extend the range to the 
right or down. In-Sight highlights the range: 



4. Release O. In-Sight opens the Bdit menu. 

5. From the Edit menu, select a command and cHck X. 


^ A ► Worksheet: Select a Row or Column 

You select an entire row or column before perfbnning a woricsheet operation through the Edit menu. Control 
Pad conventions for muJti-cell selection are: 

Select entire row 

A 


Select 

entire <^^^ 
column 


Extend 

range 

right 


Extend range down 
To select a range, see Selecting a Cell or Cell Range . 
To Select an Entire Row or Column 


\ 
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f 
\ 

I • Keyboard cursor = Control Pad cursor 

I • Shift-cursor = block selections 

I • In the Formula Builder, you can select functions by typing their names, which are case-insensitive. 

Formula Builder recognizes a function as soon as you type enough characters to uniquely identify it 

I . F2=n= 

i- • F3 = O = Edit menu (so does shift-up-airow (then release) 

• Enter - X button 

• Esc = A button 

• F2 + enter = trigger 


^ A ► Server: Commands 


The following commands are available at the Server prompt 


Syntax 
acquire 

clear cellrange 
getactive cellrange 
getcell cellrange 
getdim 
getmax 

getvalue cellrange 
help 

setae tive cellnum string 
setcell cellnum string 

timeout x 

trigger 

update 


Description 

Acquire image and run job. 
Clear cells. 

Get enable state of cells. 
Get ceU definitions. 
Get spreadsheet dimensions. 
Get max row and col of cells. 
Get output value of cells. 
Gets a hst of commands. 
Set enable state of cells. 

Set cell definitions. You can enter ?str!ngs?, numeric values, or valid 
formulas. 

Milliseconds until command timeout 
Get output value of cells. 
Run job. 


Parameters are: 


• cellnum. Coordinates of cell in the spreadsheet Case-insensitive. For example, cl. 

• cellrange. Coordinates of a cell or range of cells. For example, c7 or c7:el3 

• string. A character string that defines the contents of the cell. 
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^ A ► Acquire: Functions Reference 

The Acquisition functions and structures, automatically present on the woricsheet in row 0, represent the 
image and the external input sources that can force the worksheet to update. For example, Acquirelmage{), 
located m ceU $A$0, acquires an image— a fundamental step for any application. These functions do not 
appear m the Fomiula Builder function list because they have dedicated cells in row 0. 

This section discusses the foUowing topics: 

• Getting Started with Acquisition 

• Selecting a Lens 

• Field-of-View Table 

• Lighting Guidelines 

• Lighting Techniques 

• Controlling Variable Lights 

• Controlling Exposure 

• Acquisition Reference . 

In-Sight stores the acquired image an Image structure, used as the default image data source by many other 
vision processing functions. 


^ A ► Acquire: Getting Started 

A typical inspection application acquires an image in response to an external trigger signal connected either 
to the camera's trigger inputs or to the Vision Processor's discrete or serial inputs. This topic describes how 
to configure In-Sight for acquisitions triggered through the camera. Because acquisition is an essential part of 
a vision application, In-Sight places the acquired image in the top row of the worksheet: 



1- A i 1 ^-C 

#— J|W 








Image structure m $A$0 stores the acquired 
image. AcquirelmageQ acquires the image and 
controls the camera and lights 

You cannot move or delete cell $A$0, since most vision functions rely on the default image by default 
^ To Acquire an Image 

1 . Choose and install a C-mount lens. For suggestions, see Se/ectint^ a Lens . 


\ Appendix I - Page 11 4 

t >iSDOCID: <WO 01 1 1 445A2_I_> 


wo 01/11445 


PCT/USOO/22383 


2. Choose and install a light source. For suggestions, see Lishtim^ Guidelines . 

3. Connect a trigger source to the camera's trigger uputs. Common hardware triggers include photo 
eyes, proximity sensors, and PLDs. 

Place a representative object under the camera and obtain a preliminary image: 

a. Click and release the A button, select Live from the System menu, and click X to enter live 
mode. Interactively adjust the object location, camera height, aperture, and focus until satisfied 
with the image. 

b. Click A twice to exit live mode, acquire the last image, and return to the worksheet. To 
manually acquire a new image at any time, hold □ and click X. 

Move to cell $A$0, which contains an Image stmcture that stores the acquired image. Click X to 
open the AcquirelmageO property sheet, through which you define values that that control the camera 
and lights. 

??Set the trigger source, options include camera, continuous, manual, discrete, serial port 0, serial 
port 1, a timer, and software triggers defined in the worksheet To specify the camera's trigger ii^ut 
as tfie trigger source, select Source, click X to open the list, and then select camera. Click OK to 
close the property sheet. 

Set the exposure time. For this exercise, increase the value from the default to 100. In an application, 
the shutter speed depends on part speed, inspection rate, light level, and lens aperture. Other image- 
related values set through AcquirelmageO include the first scan line to acquire, the number of scan 
lines to acquire, the video gain (contrast), and video offset (brightness). 

Click OK to close the AcquirelmageO property sheet. 

Apply a trigger signal through the camera's trigger inputs. In-Sight responds by acquiring an image 
and displaying it on the monitor. 



^ A ► Acquire: Selecting a Lens 

Selecting a lens is an important part of creating a successful machine vision application, but a detailed 
discussion of optics is beyond the scope of this manual. General fectors influencing the choice include: 

• The desired field-of-view^ which is the maximum visible area seen through tfie lens. Basically, the 
field-of-view must be large enough to include all features of interest plus an adequate positional 
tolerance. It must be small enough to avoid wasting resolution on unimportant objects. See the Field- 
of-View Table . 

• The working distance from the camera to the object. Physical or mechanical constraints often 
influence the minimum practical working distance. For the same field of view, increasing the working 
distance requires increasing the focal length of the lens, which reduces depth of field. Sometimes you 
can use mirrors or prisms to improve camera placement. 

• The physical size of the features. Small features dictate a short woiicing distance, a long focal length, 
or both. 

• The pixel resolution required for inspection. The image processing and feature extraction algorithms 
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in the application depend on receiving an adequate amount of feature data from the image. The 
important features must span a sufficient number of pixels or else the software cannot reliably 
recognize them. Keeping the field of view as small as practical generally increases the size of the 
features in the image. 

For information about Cognex C-mount lenses, see Lens Reference . 



^ A ► Acquire: Field-of-View Table 

Start with either the length of the fieldof-view or the size of the smallest feature, both in inches. Then look up 
the focal length (16, 25, 50, or 75 mm), working distance (Dist, in inches), and extension-tube size (Ext, in 
millimeters) that siqjports the measurement. When possible, favor shorter working distances to increase 
resolution and shorter extension tubes to decrease lens aberrations. Note that this table ignores depth of 
field, which depends on focal length, working distance, and aperture. 


FOV 

Minimum 

16 mm 

25 mm 

50 mm 

75 mm 


Feature 





0.30" 

0.0018" 




Dist: 11.5" 






Ext: 65.0 mm 

0.35" 

0.0021" 




Dist: 11.5" 






Ext: 55.0 mm 

0.40" 

0.0024" 




Dist: 12.0" 






Ext: 45.0 mm 

0-50" 

0.0030" 




Dist: 12.5" 






Ext: 35.0 mm 

0.60" 

0.0036" 



Dist: 9.0" 

Dist: 13.5" 





Ext; 20.0 mm 

Ext: 26.0 mm 

0.70" 

0.0042" 



Dist: 9.5" 

Dist: 14.5" 





Ext: 16.0 mm 

Ext: 2Z0 mm 

0.75" 

0.0045" 



Dist: 10.0" 

Dist: 15.0" 





Ext: 16.0 mm 

Ext: 20.0 mm 

0.80" 

0.0048" 



Dist: 10.0" 

Dist: 15.5" 





Ext: 15.0 mm 

Ext: 18.0 mm 

0.90" 

0.0054" 



Dist: 11.0" 

Dist: 16.5" 





Ext: 12.0 mm 

Ext: 15.0 mm 

1.00" 

0.0060" 

Dist: 4.0" 

Dist: 5.5" 

Dist: 11.5" 

Dist: 17.5" 



Ext: 3.0 mm 

Ext: 5.0 mm 

Ext: 11.0 mm 

Ext 13.0 mm 

1.25" 

0.0075" 

Dist: 4.5" 

Dist: 6.5" 

Dist: 13.5" 

Dist: 20.0" 



Ext 3.0 mm 

Ext: 4.0 mm 

Ext: 8-0 mm 

Ext 10.0 mm 

1,50" 

0.0090" 

Dist: 5.0" 

Dist: 7.5" 

Dist: 15.0" 

Dist: 22.5" 



Ext: 2.0 mm 

Ext: 4.0 mm 

Ext: 7.0 mm 

Ext: 7.0 mm 
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I 

1.75" 

0.0099" 

Dist: 5.5" 

Dist- 8 5" 

DiQt- 1 7 ft" 

DUt- 7S ft" 




Piff" 7 O mm 

Pvt" ^ ft ITIITI 

pYt* ^ ft mm 
HAi. j\f null 

Pvt' ^ ft t^im 

izxx. D.KJ nun 


2.00" 

0;0120" 

Dist: 6.0" 

Dist: 9.5" 

Diet- 1 0 ft" 

T\{ct' 7Si ft" 

t 



XJlAI. £.,\J IJIJII 


OA.L. D\3 JIUII 

HXl. JIUII 


2.25" 

0.0132" 

Dist: 7.0" 

Dist- 10 0" 

ni<:t* 9 1 ft" 


i- 




pYt* 9 ft mm 
CAK, null 

CAi. j.u null 


|: 

2.50" 

0.0147" 

I.J 

riict* 1 1 ft" 

nicf" 71 ft" 
i-'lSl, Zj,\J 





I^>Al. 1 Ililll 

£1AI. 1 .J IIIIII 

nxi, j.u mm 


i 

2.75" 

0 0167" 

nict- 8 ft" 

Oict- 1 7 ft" 






CXI. l.U IlUil 

Ext: 1.5 mm 



z 

1 

3.00" 

I/. V I / / 


r>ict* 1 'x ft" 



i 



inxi. 1 .u mm 

Ext: 1 .0 mm 



j: 




L^lSt. ID.U 



\ 



xixt- l.U mm 

Ext: l.U mm 





A fill A" 

UlSt. 1 J .U 

UlSt. lo.J 



I 



Ext wone 

Ext: l.U mm 



I 

I 


A AliC/l " 

yj.yJZty* 


Dist: 18.5 






Ext: none 

Ext 1 .U mm 




< AA** 


i^ist: 1 3.0 

Dist: 20.0 






Ext: none 

Ext: 1.0 mm 




6.00" 

0.0351" 

Dist: 15.5" 

Dist: 24.0" 






Ext: none 

Ext none 




7.00" 

0.0411" 

Dist: 18.0" 

Dist: 28.0" 


— 




Ext: none 

Ext: none 




7.50" 

0.0439" 

Dist: 19.0" 

Dist: 30.0" 






Ext: none 

Ext none 




8.00" 

0.0468" 

Dist: 20.5" 







Ext/ione 




\ 

9.00" 

0.0528" 

Dist: 22.5" 




t 



Ext/iowe 





10.00" 

0.0585" 

Dist: 25.5" 




i 



Ext: none 





For information about Cognex C-mount lenses, see Lens Reference. 

i 



A ► Acquire: Lighting Guidelines 

Lighting is vitally important for machine vision applications. The general goal is to make the in^rtanl 
features plainly visible in the image, so that the image processing and feature detection algorithms can start 
with the best possible pixel data. Specific goals might include fieezing motion, increasing edge shaipness, 
minimizing or creating shadows, removing or creating reflections, and increasing the contrast between feature 
pixels and background pixels. 
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The optical properties of the feature and background surfaces strongly influence the lighting technique likely 
to yield good results. Smooth, reflective, specular surfeces differ from rough, dull, diffuse surfaces; flat 
surfaces differ from three-dimensional surfaces; etched differs from polished; copper differs from solder, and 
so on. One place to start when evaluating lights is to identify any differences in color, texture, or other optical 
properties that distinguish the features fix>m the background You can then select hghts that exploit the 
differences to make the features more prominent For example, text etched into a mirror would scatter light, 
but its background would reflect it. 

The goal of the application also influences lighting. An plication that measures the size of a three- 
dimensional part should avoid casting shadows that might cause confusion during measurement. On the other 
hand, an application that singly detects the presence of the part might benefit from conspicuous shadows 
that are absent when the part is absent. The solution depends on the purpose. 

For information about Cognex lights, see Lishis Reference . 


Light can be white or colored, diffuse or directional, on-axis or off-axis, oblique or F)eix)endicular, 
unidirectional or onmidirectional, and continuous or strobed The wide range of choice makes it difficult to 
offer generalized suggestions. General techniques and rules of thumb include: 

• Ambient lighting is usually undesirable, partly because it is uncontrolled and often strongly variable. 
Another problem is that both florescent and incandescent sources tend to oscillate at the 50 or 60 Hz 
line frequency. Consider isolating the subject from ambient tight, so that the controlled source 
dominates the light used for imaging. 

• Back lighting provides strong contrast between object and background, creating a silhouetted image 
appropriate for algorithms like blob analysis that require a near-binary image. On the other hand, it 
eliminates gray levels and surfece detail. 

• Brightlield lighting uses specular reflection to highlight smootfi, reflective areas and darken rough 
textured areas. To create a brightfield effect, place the light on (or near) the lens axis: 

Light Lens 
\\\^ J / y Rough surface 


Smooth surfaces reflect light into the lens and appear bright; rough surfaces scatter light and appear 
dark {The mirror image of the light itself is out of focus, effectively diffusing it) A potential problem 
with brightfield lighting is excessive glare from the lai^ge amount of light reflected into the camera. 


COGIMEX 



^ A ► Acquire: Lighting Techniques 



Appendix I - Page 118 


.011144SA2J. 


wo 01/11445 PCT/USOO/22383 



Darkfield lighting uses specular reflection to darken smooth surfaces and brighten rough areas. To 
create a darkfield effect, place the light off the lens axis: 

Rough surface 
(bright feature) 

Smooth surface 
(dark background) 


Most of the light reflects from the smooth surface away from die lens, but some of the light striking 
rough features reflects into the lens. Darkfield lighting highlights edges on a daik background Only 
part of the hght striking the feature scatters into the lens, so darkfield requires relatively high light 
levels. 

Directional front lighting creates distinctive ^adows and reflections from three-dimensional, fiiee- 
standing subjects. Different angles — from oblique to high-angle to coaxial — yield differait effects. 
DtlTused front lighting is good for inspecting high-contrast parts but poor for inspecting low- 
contrast, low-profile parts. 

Omnidirectional lighting (such as ring hghting) provides even illumination and eliminates shadows. It 
is often good for close inspections or for features with significant relief It is poor for low-contrast 
subjects. 

Oblique side lighting can be used to cast shadows from features that have relief but lack contrast. 
Colored or filtered light can increase or reduce contrast. Complimentary color tends to increase 
contrast (good for pale features), and similar color tends to reduce contrast (good for dense features). 
For example, red light darkens blues and greens, so you might use a red hght to separate a blue object 
from a red background. 


For information about Cognex lights, see Lights Reference . 


^ A ► Acquire: Controlling Variable Lights 

The In-Sight hardware lets you dynamically control up to four independent banks of hghts. To do so set the 
Acquirelmage function's LightPower values. 


^ A ► Acquire: Controlling Exposure 

The amount of light that reaches the image sensor determines the brightness of the image. As you might 
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expect, increasing the exposure makes the image brighter. Finding an appropriate exposure depends on the 
details of your application, making it difficult to offer suggestions applicable in all situations. In general, you 
are seeking an exposure level that makes the important details easily visible in the image. One strategy is to 
place the features of interest near the center of the available grayscale range, seeking the highest-contrast 
image that does not saturate the brightest or darkest values. If you cannot digitize the entire brightness range 
without saturation, then skew the image toward the salient detail. 

Several factors — hght level, lens aperture, exposure time, and video gain — interact with each other to control 
exposure. Increasing or decreasing each parameter changes the image in a distinctive way. Whether the 
change is an advantage or a drawback depends on your application. Tradeoffs include: 

• Increasing the light level increases the exposure but is sometimes impractical. Nonetheless, providing 
adequate light is almost always the first-choice solution for exposure problems. 

• Increasing the aperture increases the exposure but decreases depth-of-field and lens sharpness. The 
shallow depth-of-field associated with long focal lengths or short woricing distances can be a problem 
for objects with significant depth or working distances with significant variabihty. In gaieral, try to 
obtain generous depth-of-field unless you are intentionally blurring unwanted foreground or 
background detail. Try to use middle to upper-middle apertures when possible, avoiding the widest 
and smallest apertures. 

• Increasing the exposure time increases the exposure but risks blur due to motion. Applications 
involving higji part speeds or inspection rates require the use of a brief exposure or a strobe light to 
fteeze motioiL 

• Increasing the video gain makes the image sensor more sensitive to light but can increase the visibility 
of video noise, making the image grainy. You set gain and a related parameter called offset through 
the Acquirelmagc function. The two parameters have the following relationship: 

output ~ (input X gain) + offset 

Increasing gain increases contrast (the range between the brightest and darkest pixels). Increasing 
offset increases brightness by shifting all grayscale values up by the same anK>unt. Ignoring the fact that 
grayscale values saturate at the minimum and maximum values (0 and 255), offeet does not change the 
range. 

As a general rule of thumb, first add light, then add aperture, then add gain. 


^ A ► Acquire: Function Reference 

Acquirelmaae Acquires an image and stores it in an Image stmcture. Also controls the trigger source, 

variable lights, and the camera's analog-to-digital converter. 
hnage stnicmre Stores an image. Most vision processing functions by default refer to the acquired image, 

generated by AcquirelmageQ and stored in cell $A$0. 
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^ A ► Acquire: Acquirelmage function 


Description 

Heading 
Syntax 

Inputs 


Acquires an image and stores it in an Image structure. Also controls the trigger source, 
variable lights, and the camera's analog-to-digital converter. 
None. Always in cell $A$0. 

AcquireImage(Trigger, Manual, Exposure, Start Row, Num Rows, Light Power, Gain, 
Offset) 

Trigger Trigger source. An image is acquired at the specified internal or external 

event To define a soft trigger, see SetEvent . 
Manual Enables the manual trigger (Control PadD +X). When enabled, the 

manual trigger does not preen^t the specified Trigger. AcquirelmageQ 

consequentiy acquires an image at either the manual trigger or the 

specified Trigger. 

Exposure Exposure time, in milliseconds. Range, 0 to 1000. Default = 33, so that 

the brightness of live images matches that of acquired images. Internally 
rounded to the duration of one scan line (64 microseconds). For more 
information, see Corttroliind Rxposure . 

Start Row The first image row to acquire. Default = 0. ??Currently disabled?? 

Num Rows The number of image rows to acquire. Valid range, 1 to 480. Default = 
480. ??Currently disabled?? 

LightPower 0-3 Brightness value for fight banks 0, 1 , 2, or 3. Valid range, 0 through 

255, where 0 is OFF, 255 is fiill brightness, and intemiediate values are 
intemiediate light levels. See Controllins Variable Lights . 

NOTE If you are using a Cognex strobe powoed through the light 
control port, you must set the Light Power value to 255. ?? 
Confirm final behavior through RR?? 
Gain Raw video gain (contrast) for the image sensor. Gain interacts with 

Offset as follows: 


Stores 

Emits 

Errors 


Offset 

Image 

Nothing. 
None. 


Output = (input X gain) + offset 

Valid range, 0 through 255. For more infomnation, see Controlling 
Exposure . 

Raw video level (brightness) for the image sensor. Valid range, 0 
through 255. For more infonnation, see Controlling Exposure , 
On success, an hnage stnicture, A\iuch stores an image. 
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Comments AcquirelmageO acquires an image and creates an Image structure in cell $A$0 to store 
the image. You cannot move AcquirelmageQ from $A$0 or create a second 
AcquirelmageO fimction. When AcquirelmageQ is enabled (the default) and a trigger 
occurs, AcquirelmageO grabs a new image from the camera and updates $A$0. 


Accumulate, Count, or Latch cells sometimes use AcquirelmageO as a signal to update 
their contents. 
See Also Image structure. Event SetEvent 



^ A ► Acquire: Image structure 


Access function 

GetPixelValue 


Description Stores an image. Most vision processing ftmctions by default refer to the acquired image, 

generated by AcquirelmageO stored in cell $ A$0- 
Values Value Description 

Greyscale Greyscale value, 0.00 through 255.00. Available 
for each pixel, specified by its row and column 
address. 

Comments Many vision processing ftmctions rely on an Image structure as a data source. Neariy all 
by default refer to the acquired image, generated by Acquirelmage and stored in cell 
$A$0. 


Comparelmage, NeighborFilter. PixelFiltcr. and Wamlmage modify pixel data and 
therefore store a new Image structure containing the modified image. To process an 
alternative image instead of the acquired image, change the Image reference from $A$0 to 
the new Image structure. 
See Also Acquirelmage . 
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A ► Blob: Overview 

A blob is a contiguous patch of pixels with a distinctive grayscale vahie. Blob analysis, also called 
connectivity analysis or connected components analysis, is a feature extraction method for finding, analyzing, 
and classifying blobs in an image. It is often used to detect natural or organic shapes — ink dots, solder blobs, 
French fries, chicken wings, and so on — that are topologically stable but plastic, rotated, or both. Apples 
rolling on a conveyor belt, for example, exhibit various ovoid shapes within a known profile (area range in 
pixels, perimeter range in pixels, number of internal holes, and so on). An apple inspection application might 
use blob analysis to exclude objects that fail to fit the profile. 

This section introduces In-Sight*s Blob fiinctions (located under Vision Processing) , which offer your 
application information about the number, location, shape, and orientation of blobs. It discusses the following 
topics: 

• Getting Started with Blob Analysis 

• Using the Blob Functions 

o Extracting a Blob Database 
o Finding Blobs in the Database 
o Sorting the Database 
o Getting Blob Results 

• Blob Reference . 

In-Sight's blob fiinctions offer automatic thresholding, the ability to select blobs by color, size, area, and 
other characteristics, and a choice of one-step or multi-step blob analysis. The one-step method, with one 
fiinction that extracts blobs, sorts them by largest area, and returns a specified number of results, is 
straightforward but less flexible and less efficient. The multi-step method, with separate fiinctions for the each 
stage, is more complex but flexible and efficient (it lets you re-sort and re-score the database without 
rebuilding it). 


^ A ► Blob: Getting Started 

In-Si^t offers both one-step and multi-step blob analysis. This topic demonstrates the basic operation of the 
one-step method Completing this exercise gives you hands-on experience with In-Sight's blob analysis 
fiinctions. 

► To Extract Blobs from an Image 

1 . Acquire an appropriate image. For this exercise: 

a. Open the part sample image, print it, and retum to this topic. Place the printed image under the 
camera. 

b. Click and release A, select Live fiiom the System menu, and click X to enter live mode. 


SOOCrO: <WO 01 1 1445A2_L> 


Appendix I - Page 123 


wo 01/11445 


PCT/USOO/22383 


Interactively adjust the image location, camera height, aperture, and focus until satisfied with the 
image. 

c. Click A twace to exit live mode, acquire the last image, and return to the worksheet. 
To acquire a new image at any time, hold D and click X. 

2. Leaving cell Al empty, move to cell A2 and click Xto open the Fonnuia Builder . 

NOTE Tiy to leave a blank row above functions that emit formulas. In-Sight prints descriptive labels 
above emitted fomiulas if it has room for the labels. If the row above is occupied, it emits 
only the numeric values, without labels. 

3. From the Vision Processing category, select Blob, and then open the ExtractBlobs property sheet. 

4. To define the region of interest, select the Region heading and click X. In-Sight hides the worksheet 
and displays the Region cursor, which you interactively adjust with the Control Pad Surround the 
area containing the part sample, which has four round holes and one larger rectangular hole. Click X 
to return to the property sheet. 

5. You define the expected characteristics of a blob by setting parameters on the ExtractBlobsO 
property sheet. Initially, try the following values: 

o Number To Find, the number of blebs to extract. Increase this value to "4", so that you can 

get results about more than one blob, 
o Blob Color, the color of the blob. Select Either, to extract both White and Black blobs, 
o Background Color. If the background of your image is mostly dark, select Black; if it is 

mostly light, select White. 
o Area Limit: Max, the largest number of pixels in the blob. Try setting this value at 5,000 

pixels (probably smaU enough to exclude the rectangular blob). 


For now, leave the other values unchanged. 


6. Extract the blobs by clicking Run. ExtractBlobsQ analyses the image for blobs that fit the selection 
criteria, then draws an outline around them: 


Region of interest 

BlobO 

Blob 2 

Blob 3 

Blob 1 


Even though the original image is grayscale, the blobs in the database are binary, because the image is 
segmented at a threshold value. Each Blob has an index, starting with zero, used to refer to it when the 
results contain more than one blob. 


You can experiment with different selection criteria by changing their values. For example, you could 
increase the Area Limit value to include or exclude the larger rectangular blob. Each time you click 
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7. 


8. 


Run, ExtractBlobsO updates the blob database and blob outlines. Restrictive values tend to yield 
fewer blobs, and pemissive values tend to yield more blobs. 

Examine the results. When done experimenting, click OK to accept the current parameter values. 
For each blob, ExtractBlobsQ emits the X and Y location of the centroid, the angle of the axis of the 
minimum moment of inertia, and other result values to the worksheet: 



To use a result value in a fomiula, create a reference to its cell. If you don't need one of the 
automatically generated result cells, you can delete it . 

By default, In-Sight displays the blob graphics only when you highlight the Blobs stmcture, as 
described in F/vover Graphics , To display the blob graphics all the time, set the ExtractSortBlobO 
function's Show parameter to Show All. 


ExtractBlobsO always sorts blobs by maximum area. To sort them by other criteria, you use the multi-step 
method. 


^ A ► Blob: Multi-step Method 

In-Sight offers both one-step and multi-step blob analysis. The one-step method combines several 
intennediate operations, simplifying the operation but reducing flexibility. The multi-step method separates 
the underlying opmtions, giving you more control but increasing complexity. 

This section describes the typical sequence of operations: 

1. Extracting a Blob Database fExtractBlobs) 

2. Finding Blobs in the Database (FindBlobs^ 

3. Sorting the C^atabase (Son Blobs) 

4. Gcttina Blob Results . 

Separating the steps (building the database, scoring it, and sorting it) avoids the need to the database for 
each search, improving flexibility and efficiency. 


SDOCID: <WO 01 1 1 445A2_L> 


Appendix I - Page 1 25 


wo 01/11445 


PCT/USOO/22383 


^ A ► 


Blob: Extracting Database 


The first step for blob analysis is to define the features that distinguish a blob from its background You 
define blob characteristics through ExtractBlobs. which builds a blob database when you click OK or Run 
on the property sheet The resulting Blobs structure stores the database, for subsequent processing by 
FindBlobs. SortBiobs. or TransBlobToWorld . 

Extraction criteria include: 

• Threshold: a grayscale value, fiiom 0 to 63, used to recognize background pixels. If the background 
is "White," aU pbcels with grayscale values below the threshold are background pixels. If the 
background is "black," pixels above the threshold are background pbcels. You can enter a threshold 
value manually or find the best value automatically by specifying - 1 , which automatically confutes the 
threshold that generates the best contrast between object and background. 

• Background Color: Sets the background color, either black or white. 

• Blob Color: Sets the blob color black, white, or either, 

• Include Holes: Holes are background-colored pixels inside the blob. Choose OFF to exclude holes 
fix>m blob statistics, or ON to include them. 

• ??Expand this table to include the others. 

After defining the profile you expect for a blob, chck OK or Run on the property sheet ExtractBlobsQ then 
perfomis connectivity analysis using the ^ecified selection critma. It stores the resulting database in a Blobs 
structure, emits the number of blobs in the database, and draws a result graphic highlighting the blobs and 
their indices: 



Even if the original image is grayscale, the database itself is binary. 
After a creating a database, you can find blobs in it sort it or both. 
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^ A ► Blob: Finding Blobs 

After buildins a Blob database, you can find blobs in it with the FindBlobs function. Basically, this operation 
computes a score for every blob in the database. The score value depends on several criterion, each with an 
assignable weight, allowing you to exactly define the relative importance of each criterion. 

Criterion Description 
Number to Find The number of blobs to find in the database. Find stops scoring y/hcn it reaches this value. 
Acceptance A minimum acceptable score, 0 through 100. 
Threshold 

Angle xxxx 

Area The area, in pixels, of the blob. 

Elongation The elongation value — the ratio of the moments about the principal axes of inertia. 
Holes The number of holes within the blob. 

Perimeter The number of pixels on the perimeter of the blob. 
Spread The spread value — a rough measure of compyactness. 

Specifying "narrow" or "wide" ranges naturally tends to decrease or increase the number of results returned 
from the database. 


A ► Blob: Sorting Database 

Sorting the database lets you rearrange it, selectively eliminating blobs. Sorting the database is an optional 
step, but you can sort more than once, to progressively prune the database. 

Parameters are: 

• Number to Sort. ??Throws out the rest. 

• Sort By. The criterion for sorting. ??Give the list of values?? 

• Reference: Sets the location of the reference point, used when Extract is "Distance." You can set the 
reference point either by entering an absolute pixel grid coordinate into the Row and Col text boxes, 
or by clicking Cursor and dragging the cross-shaped cursor in the image. 
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^ A ► Blob; Getting Result Values 


ExtractBiobs creates Blobs structure that stores the blob database. FindBIobs. SortBiobs. and 
TransBlobToWorld refer to this Blobs structure as a data source and generate a second Blobs structuie to 
hold the modified database. They also emit useful data from the Blobs structure to the woricsheet, for use by 
formulas that process the blob results: 



For details about the emitted values, see Biobs Structure, 

Any fomiula can refer to an emitted formula to obtain its value for further processing. If you don't need : 
result, you can throw away the emitted formula. 


^ A ► Blob: Function Reference 


Stores a database of blobs, each with a zero-based index and a profile of measured 
values. Coordinates are in Image units (pixels) unless converted by TransBlobToWorld 
Builds a blob database, optionally sorting it. Stores its results in a Blobs structure. Emits a 
specified number of blobs, sorted by largest area. 

Scores blobs in a Blobs database by closeness to ideal values, each with an assignable 
weight. Stores a new, scored Blobs structure. 

Sorts a Blobs structure by specified criteria. Stores a new, sorted Blobs structure. 

TransBlobToWorld, under Coordinate Transforms, converts blob results to Worid coordinates Results 
fimctions, under Data Access, that get results from a Blobs structure are GetAngle. GetArea. GetCol. 
GetColor , GetElon^tion, GetHoles, GetMaxCol. GetMaxRow. GetMinRow. GciNFound. GetPerimeter 
GetRow. GetScore- GetSpread . ' ' 


Blobs structure 
ExtractBiobs 
FindBlobs 
SortBiobs 


^ A ► Blob: Blobs structure 
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Description 
Values 


Stores a database of blobs, each with a zero-based index and a profile of measured 
values. Coordinates arc in Image units (pixels) unless converted by TransBlobTo World . 


Value 
Index 


Angle 


Area 


Column 


Color 

Elongation 
Holes 

MaxCol 


MaxRow 


MinCol 


Access function 


GetAnnle 


Description 

Zero-based index identifiying a particular blob. The 
first blob is indexed 0.00, the second is 1 .00, and 
so on. 

Angle of the major axis of elongation, in CCW 
degrees. Measured from the image row axis unless 
converted to World coordinates by 
TransBlobToWorldQ. 


NOTE The angle value ranges fix)m 0.00 through 
1 80.00. It does not distinguish the 
"direction" of the blob. For example, a 
blob with a 90-degree rotation reports a 
90-degree angle. The same blob rotated 
1 80 degrees also reports a 90-degree 
angle, not a 270-degree angle. If you must 
distinguish the absolute direction, consider 
using pattern matchinti instead of blob 
analysis. 

Number of pixels inside the blob. ??Always in 
pixels even if the Blobs structure is converted to 
World units. ??Includes holes if XXX; excludes 
holes if YYY?? 

Centroid coluiim coordinate, ??offset by reference 
point??. In pixels unless converted to World units 
by TransBlobToWorld{). 
Blob color, relative to the threshold. 0.00 for a 
black blob, and LOO for a white blob. 
Ratio of the major axis to the minor axis. 
Number of background-colored areas inside the 
blob. 

Maximum column coordinate. The blob's right- 
most point In pixels even if the Blobs stmcture is 
converted to World coordinates (because the value 
in World coordinates might be a completely 
different point on the blob perimeter). Not emitted. 
Maximum row coordinate. The blob's top-most 
point. In pixels even if the Blobs structure is 
converted to World coordinates (because the value 
in World coordinates might be a completely 
diflFerent point on the blob perimeter). Not emitted. 
Minimum column coordinate. The blob's left-most Get MinCol 
point In pixels even if the Blobs stmcture is 
converted to World coordinates (because the value 
in World coordinates might be a completely 


GetArea 


GctCol 


GetColor 

GetElongation 
GetHoles 

GetMaxCol 


GetMaxRow 
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Comments 
See Also 


NFound 
Perimeter 


Row 


Score 
Spread 

None. 
FindBlobs. 


GetMinRow 


GetNFound 
GetPeiimeter 


different point on the blob perimeter). Not emitted, 
MinRow Minimum row coordinate. The blob's ''bottom" 
point In pixels even if the Blobs structure is 
converted to World coordinates (because the value 
in World coordinates might be a completely 
different point on the blob perimeter). Not emitted. 
Number of blobs in the database. 
Number of pixels on the perimeter, summed along 
the blob boundary. Not emitted. ??Always in pixels 
even if the Blobs stmcture is converted to World 
imits. ?A 1 -pixel blob has a 4-pixel perimeter.? 
Centroid row coordinate. ?offset from the reference GetRow 
point?. In pixels unless converted to World units by 
TransBlobToWorldQ. 

As computed by FindBlobs, 0.00 to 1 00.00. GetScore 
A rough measure of blob compactness. GetSpread 

SortBlobs. TransBlobTo World 


^ A ► Blob: ExtractBlobs function 


Description Builds a blob database, optionally sorting it Stores its results in a Blobs stmcture. Emits a 

specified number of blobs, sorted by largest area. 
Heading Vision Processing^lob 

Syntax ExtnactBlobs(Image, Fbcture, Region, . . . , Show) 

I"Pu*s Image Image data source, a reference to an Image stmcture . Default is $A$0. 

Fixture Fixture origin, defined by row, column, and angle offsets, typically to 
— ^Row compensate for image-to-image variation in position, orientation, or both. 
— Column Row and Column are offeets, in pixels fix>m the image origin. Theta is a 
— ^Theta rotation from the image row axis, ± 360° CCW. Defaults all 0 (the image 
origin). See Workins with Fixtures . 

Region of interest X and Y define the top-left point by ofifeets from the 
Fixture origin, in pixels. High and Wide are the height and width, in pixels. 
Angle is a rotation from the Fixture X axis, ± 360° CCW. See Defining a 
Region of Interest . 


Region 
—X 
— Y 
—High 
—Wide 
— Angle 
Num to 
Sort 

Threshold 


Upper limit on the number of blobs returned. Zero (0) for unsorted. 

Binary threshold, 0 through 255, to segment the image. Grayscale values 
the threshold are foreground pixels, and those > the threshold are background 
pixels. -1 to automatically compute the threshold that best separates the 
image into foreground and background regions (the optimum bimodal 
distributionV 
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I Include ON includes background-colored holes in the blob statistics; OFF excludes 

I Holes them. 

f Boundary ON includes blobs crossing or touching the Region edge; OFF excludes 

\ Blobs them. ??boundary blobs in interface?? 

^ Color Blob color, relative to the threshold. One of black, white, or either. 

— Blob Background color, relative to the threshold. One of black or white. 
— BG 

i Area Limit Minimum and maximum area, in pixels. 

\ — Min 

— Max 

I Show Selects the graphics to display, as described in Flyover Graphics : 

. Hideall 

} • Result grap^cs only 

I • Input and result graphics 

• Show all, vAnch di^lays iiq>ut, result, and chart (if any) graphics. 

Stores On success, a Blobs stnictiire^ which stores a blob database. 

Emits • If Num to Sort = 0: the number found 

• If Num to Sort > 0: Index, Centroid Row, Centroid Column, Angle, Blob Color, 
Score, Area, Elongation, Holes, Perimeter, and Spread. 

For details, see Blobs Stnictiire . 
Errors Invalid parameter. 

Comments None. 

See Also FindBlobs. SortBlobs. TransBlobToWorld. Getting Started with B/ob AnahsLs, 


^ A ► Blob: FindBlobs function 


Description 

Heading 

Syntax 

hputs 


Scores blobs in a Blobs structure by closeness to ideal values, each with an assignable 
weight. Stores a new, scored Blobs structure. 
Vision Processing/Blob 

F!ndBlobs(Blobs, Num to Find, match-criteria^ Show) 


Blobs 
Num to 
Find 
Accept 
Thresh 
Angle 
—Ideal 
— Range 
—Weight 
Area 


A Blobs structure, created by ExtractBlobs . 
Maximum nimiba* of matches. 

Accqjtance threshold — the minimum acceptable score, 0 through 100. 

Angle of the major axis, in counterclockwise degrees. Range is a bracket, in 
± degrees. Weight is importance in scoring, 0.00 to 100.00. 


Area, in pixels. Range is a ± bracket, in pixels. Weight is importance in 
cr-rtrinfT o on tHrrtufffi inn no 
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I — ^Range 


— Range 
—Weight 

£longation Ratio of major axis to minor axis. Range is a ± bracket, centered on the 

— Ideal ideal ratio. Weight is importance in scoring, 0.00 to 100.00. 
— Range 
— Weight 

Holes Number of holes, or background-colored areas inside the blob. Range is a 

— Ideal ± bracket. Weight is importance in scoring, 0.00 to 100.00. 


-Weight 

Perimeter Perimeter, in pixels. Range is a ± bracket, in pixels. Weight is importance in 

— Ideal scoring, 0.00 to 100.00. 
— Range 
—Weight 

Spread A rough measure of blob compactness. Range is a ± bracket. Weight is 

— Ideal importance in scoring, 0.00 to 100.00. 
— Range 
— Weight 

Spread Ideal: A rough measure of blob compactness. 

Range is a ± bracket, in pixels 

Weight: Importance of Spread. 

Show Selects the graphics to di^lay, as described in Flvover Graphics : 

• Hideall 

• Result graphics only 

• Input and result graphics 

• Show all, which displays input, result, and chart (if any) graphics. 
Stores On success, a Blobs stmcture. which stores a blob database. 

Emits For each blob: Index, Centroid Row, Centroid Colunm, Angle, Blob Color, Score, Area, 

Elongation, Holes, Perimeter, and Spread. For details, see Blobs Structure . 
Errors Invalid parameter. 

Comments None. 

See Also Finding Bl obs in the Database. ExtractBlobs. SortBlobs, TransBlobToWorld 


^ A ► Blob: SortBlobs function 


Description Sorts a Blobs structure by specified criteria. Stores a new, sorted Blobs stmcture. 
Heading Vision Processing/BIob 

Syntax SortBlobs(Blobs, Num to Sort, Sort By, Reference, Show) 
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Inputs 


Blobs 

Num to 
Sort 
Sort By 


Reference 
— Row 
— Column 
— Angle 
Show 


A reference to a Blobs structure, from ExtractBlobs, FindBlobs. or 
SortBlobs . 

Number of blobs to sort. 

The criterion for sorting, one of: 

angle Minimum to maximum, 

area Maximum to niinimunx 

distance From the reference point 

elongation The ratio of major to minor axes, ?smallest to largest? 
grid Rows, then columns, from the reference point 

holes Maximum to minimunx 

col ?Left to right? 

Row TTop to bottom? 

perimeter Maximum to minimum, 

spread A measure of compactness, ?smallest to largest? 

Sort reference row and column, in pbcels fiom the image origin. Angle is a 

rotation, ± 360 degrees CCW from the image row axis. 


Selects the graphics to display, as described in Flyover Graphics : 


• Hide all 

• Result gr^hics only 

• Input and result graphics 

• Show all, which displays input, result, and chart (if any) graphics. 
Stores On success, a Blobs stiTicture. which stores a blob database. 

Emits For each blob: Index, Centroid Row, Centroid Column, Angle, Blob Color, Score, Area, 

Elongation, Holes, Perimeter, and Spread. For details, see Blobs structure . 
Errors Invalid parameter. 

Comments None. 

See Also Sorn'm? the Blob Database . Exh^actBlobs, FindBlobs. TransBlobToWorld 



Appendix I - Page 1 33 

SDCCID: <WO 01 1 1445A2J_> 


wo 01/11445 


PCT/USOO/22383 


^ A ► Clocked Data: Overview 

The Clocked Data functions perform time-related processing. Several functions— Accumulate, Count, and 
Latch — ^keep various kinds of running totals. Another function — DelayLineQ — stores the history of a value i 
a buffer, typically to delay an output signal to synchronize it with a device deeper in the production line. 

This section introduces the Clocked Data fiinctions, discussing the following topics: 

• Getting Started with Clocked Data 

• Clocked Data Reference . 

NOTE To access the Clocked Data Storage functions from the Formula Builder, click Advanced. 


^ A ► Clocked Data: Getting Started 

In this section, you create a DelavLine buffer that monitors the row result fix>m a blob extracted from the 
image. The result looks Uke this: 


A2=: DefavLffte($A^.C1 .10.0) 


B 


357,684 


3S7^66I--¥f5^ 


0i)18 


!i67;265 


Delay object, 
stores the buffer 


T 


IvOCffL 


3S7.m 


Row centroid, 
current image 


Mean of \ Largest value 

buffered values \ in buffer 


Buffered value, 
previous image 


Standard 
deviation 


Smallest value 
in buffer 


► To Create a Buffer 


1 . Acquire an appropriate image. For this exercise: 

a. Open the part sample image, print it, and return to this topic. Place the printed image under the 
camera. 

b. Click and release A, select Live from the System menu, and click X to enter live mode. 
hiteractively adjust the image location, camera height, aperture, and focus until satisfied with the 
image. 

c. Click A twice to exit live mode, acquire the last image, and return to the worksheet. 


To acquire a new image, hold □ and click X. 
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2. Create the data to buffer. A convenient value for this exercise is the centroid row value from a blob: 

a. From cell Al, click Xto open the Formula Builder. 

b. From the Blob heading, open the ExtractBlobs property sheet. 

c. Leaving the defaults unchanged, click OK to close the property sheet. ExtractBlobsQ builds 
and sorts a blob database in one step. It also emits various results, including the centroid row 
and column: 


Blobs object, from 
ExtractSortBlobsQ ^ 

Row centoid, 
emitted by GetRowQ 


!C1= GetRow($A$T^) 


"1 


I'-. ■ "7 















3. Move to cell A2 and click X 

4. Click Advanced to view the Clocked Data Storage category. 

5. Open the EtelayLineQ property sheet Set the foUowing values: 

o Leave the Event, Num Steps, and Reset values unchanged By default, I>elayLineO updates 

its internal buffer each time the system acquires an image, 
o Chck the Data value, temporarily closing the property sheet so that you can interactively create 

a reference to a data source. For this example, select cell CI, the row centroid. 
o Chck OK to close the property sheet. DelayLineQ creates an empty buffer, stores it in a Delay 

stRicture, and emits a block of formulas to display values from the Delay structure. At this 

point, the bufFer is empty, so the emitted values are aD #ERR. 
o Click and release A to open the System menu. Select Triggers to open the Triggers menu, and 

then click Manual. In-Sight acquires a new image and updates the buffer, which now contains 

one value. 

o Click Manual at least ten more times to fill the buffer with values: 



Delay object, 
stores the bufTer 


Row centroid, 
current image 


Buffered value, 
previous image 


Standard 
deviation 


Smallest value 
in buffer 


Small differences in lighting usually cause the histogram values to change shghtly from image to 
image. The buffer reflects these differences. After the buffer fills, the oldest value drops out. 
(You can set the number of time increments to buffer in the DelayLineQ property sheet. The 
default, unchanged here, is 10.) 
o From the Triggers menu, enable Continuous. Li-Sight acquires images as quickly as possible, 
updating the buffer to reflect them. 
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^ A ► Clocked Data: Function Reference 

Accumulate Keeps a running total of a specified value, updating at a specified event 
Count Starting at a specified integer, adds one to a running total at each event 

Delay structure Stores a DelayLineQ buffer. 

DelayLine Buffers the history of a value. Emits the current, last, mean, and standard deviation values. 

Latch Returns a specified value at a q^ecified event. 

Functions that retum statistics from a Delay structure are GetCount. GetMax. GetMean. GetMin, GetSDev. 
GetSum . and GetValue. 


^ A ► Clocked Data: Accumulate function 

Description Keeps a running total of a specified value, updating at a specified event 
Heading Advanced/Clocked Data Storage 

Syntax Accumulate(Event, Value, Reset, Preset) 

Inputs Event An event that forces an update of the accumulated value. Must be a 

reference to a cell containing AcQuirelmage (the default). Button, or Evait 
Value The value to accumulate at each Event. Can be a cell reference. Positive 

to increment, negative to decrement 
Reset When ON, resets the current total to the Preset value, at the next Event. 

Preset First value at startiq) or reset An integer. 

Returns The current running total. 

Emits Nothing. 
Errors hivahd parameter. 

Comments At creation or reset, the accumulator contains tfie Preset value. 

See Also Count DelavLine. Latch . 


A ► Clocked Data: Count function 
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Description Starting at a specified integer, adds one to a ninning total at each event. 
Heading Advanced/Clocked Data Storage 

Syntax Count(Event, Max Value, Reset, Preset) 

Inputs Event An event that forces an i^xiate of the running total. Must be a reference to 

a ceD containing Acguirelmage (the default). Button, or Event 
Max Value The maximum value for the counter, an integer. When the counter reaches 

Max Value, the running count resets to Preset at the next Event. 
Reset When on, resets the current total to the Preset value, at the next Event 

Preset First value at startup or reset An integer. 

Returns The counter value at the most recent Event. 

Emits Nothing. 
En^ors Invalid parameter. 

Comments At creation or reset, the buffer contains one value — the current data value. 
See Also Accmnulate, DelavLine. Latch . 


A ► Clocked Data: Delay structure 


Description 

Heading 

Values 


Comments 
See Also 


Stores a DelavLine buffer. 
Advanced/Clocked Data Storage 

Value Description 
Count Number of values in the buffer. When you define a 
buffer, you specify the number of time-intervals it will 
contain. At creation, the buffer contains only one value. 
As the buffer fills, the number of values increases until it 
reaches the specified depth. Count is the number of 
values actually in the buffer, even if the buffer is not full. 
Maximum The largest value currently in the buffer. 

The arithmetical mean of the values in the buffer. 
The smallest value currently in the buffo-. 
The standard deviation of the values in the buffer. 


Mean 
Minimum 
Standard 
Deviation 
Sum 
Value 
None. 
r>elavLine 


Sum of the values in the buffer. 

The value in the buffer at the specified time oflfeet 


Access function 
GetCoiint 


GetMax 
GetMean 
GetMin 
GetSDev 

GetSum 
GetValue 


^ A ► Clocked Data: DelayLine function 
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Description 
Heading 
Syntax 
Inputs 


Stores 
Emits 
Enrors 
Emits 

Comments 
See Also 


Buffers the history of a value. Emits the current, last, mean, and standard deviation values. 
Advanced/Clocked Data Storage 
DeIayLine(Event, Value, Num Steps. Reset) 


Event 

Value 
Num Steps 
Reset 


An event that forces an update of the running total. Must be a reference to 
a cell containing AcQuirelmage (the default). Button, or Event 
The value to buffer — a cell reference or formula. 
Numb^ of time increnients to buffer. 

Resets the buff^, eliminating previously buffered values. After reset, the 
buffer contains one value, the current Value. 
On success, a Delay structure, which stores the buffer. 


Delay 

Nothing. 
Invalid parameter. 

Current, mean, standard deviation, maximum, and minimum values. For details, see Delay 
structure . 

At creation or reset, the buffer contains one value — the current Value. 
Accumulate. Count Latch. Gettimr Started with Clocked Dala . 


^ A ► Clocked Data: Latch function 


Description 
Heading 
Syntax 
Inputs 


Returns 
Emits 
Errors 
Comments 
See Also 


Returns a specified value at a specified Event 
Advanced/Clocked Data Storage 
Latch(Event, Value) 

Event An event that forces an update of the latched value. Must be a reference to 

a cell containing Accuirelmagc (the default). Button, or Event 
Value A numeric value for ou^ut 

The latch value at the most recent Event. 
Nothing. 

Invalid parameter. 

At creation or reset, the buffer contains the current value. 
Accumulate. Count DelavLinc . 
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^ A ► Coordinate Transforms: Overview 

The Coordinate Transforms functions map values from one coordinate system to another. They are grouped 

in three subheadings, corresponding to the major In-Sight coordinate systems: 

Calibrate Establishes a coordinate transformation between two planes. Often used to create a 

calibrated transfomiation, v^ch converts in either direction between image locations (in 
Pixel coordinates) and physical locations (in World coordinates) . For example, an 
application might convert points and distances from row-and-column pixel values to real- 
world units such as millimeters or inches. To sinq)lify the process of converting results from 
feature extraction and measurement operations, In-Sight offers dedicated fimctions that 
convert a Blobs. Dist, Edges, or Patterns structure in one step. 

Although through-the-lens calibration is a common use for coordinate transfomiation, you 
can use In-Sight's calibration ftinctions for other plane-to-plane transforms. Because In- 
Sight computes the transfomi from four known points, the two coordinate systems can be 
skewed. 

Fixture Converts between a reference (Fixture) coordinate system and either World or Pixel 

values. Establishing a fixture coordinate system, based on a "landmaiic" feature identified in 
each image, compensates for variation in position or orientation between successive 
images. The Fixtured transforms a fixtured point to the equivalent point in the cunent 
image. 

Warp Maps a point in a warped image (constructed by Warplniage) back to the original, 

unwaiped image. 

This section introduces the Coordinate Transforms functions, discussing the following topics: 


Getting Started with Calibration 
Converting Pixel Values to World Units 
Understanding Calibration 


Getting Started with FLxnire Transforms 
Getting Started with Warp Transfonns 
Coordinate Transforms Reference. 



A ► Calibration: Getting Started 

To construct a calibrated transformation^ you must know the locations of several points in the real world 
and the corresponding points in the image. The transformation obtained from the set of known points can 
then convert any point in one coordinate system to the other coordinate system through interpolation, A 
common technique for specifying the real-world locations is to construct a ctilibration plate , typically a grid 
with a known q^acing. After acquiring an image of the calibration plate with the intended optical and physical 
setup, you can identify the corresponding points in both coordinate systems. 
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In this topic, you acquire an image of a sample calibration plate and use it to define a calibrated 
transfomiatioa In the next topic, you use this calibration to convert values from image units (pixels) to worid 
units (millimeters). 

^ To Define a Calibration 


^ ■ Display the sample cali bration plate (dots on a 10-millimeter grid), print it, and return to this topic. 

2. Place the printed calibration plate under the camera. 

3. Click and release A and select Live from the System nraiu, placing In-Sight in live mode. Adjust the 
focus and aperture, make the grid square in the image, :tnd click A In-Sight exits live mode, acquires 
the final image, and returns to the worksheet The image should have good contrast without shadows, 
reflections, or other image defects. 

4. Move to cell Aland click Xto open the Formula Builder. 

5 . From Coordinate Transforms, open the Calibrate heading, and then open the Calibrate property 
sheet 

6. On the property sheet, select Pixel Point 0 and click X By default, In-Sight assumes you want to set 
the image point locations interactively. Its draws the four calibration points on the image, hi^ghting 
the active point (point 0): 

Point 1 



Point2— mm^^mj^mH^Pomt 3 

7. Using the Control Pad cursor, move the point graphic to the top-left dot in the calibration plate image. 
The graphic indicates the row and column position as follows: 


Row value 
Column value 

When done, click X to accept the location. 

8. On the property sheet, click World Point O. In-Sight displays its X and Y values. Edit X to 0.00 and 
Y to 0.00, defining it as the origin of the World coordinate system 

9. Click Pixel Point 1, drag the point graphic to tenth dot to the right of Point 0, in the same row. Click 
X to accept. 

1 0. Click World Point 1, edit X to 0.00 (because the points are in the same row, and the grid is square in 
the image), and edit Y to 1 00.00 (because each dot is 10 millimeters apart, so ten dots total 100 
millimetas). 

1 1 . Click Pixel Point 2, drag the point gr^hic to the seventh dot below Point 0, in the same column, and 
click X to accept. 

1 2. Click World Point 2, edit X to 70.00 and Y to 0.00, and clickX to accept 

1 3. Click Pixel Point 3, drag it to the dot seven down and ten right from Point 0, and click X to accept. 
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14. Click World Point 3, edit X to 70.00 and Y to 100.00, and clickX to accept. The result should look 
about like this: 


Point 0 


Point 2 



Point 1 


Points 


1 5. When done, click OK to accept the point values. CalibrateO returns a Calib structure that stores the 
calibration. Other functions that require calibration data subsequently refer to the Calib structure to 
obtain the calibration. 

1 6. Go on to the next topic, where you apply this calibration to convert the values from image units to 
world units. 


A ► Calibration: Converting Values 

In the previoas topic, you defined a calibrated transformation. Here, you use it to convert the coordinates 
values in a Blobs structure from Image units (pixels) to World coordinates (millimeters). At the end, you 
convert a point from World coordinates back to Pixel coordinates. 

► To Convert Values with a Calibrated Transformation 


1 . If you have not yet completed the previous topic, do so now. 

2. Remove the calibration plate image and repbce it with the part sample image . Hold □ and click X to 
acquire a new image. 

3. Get some feature data; 

a. Leaving cell A2 empty, move to cell A3 and click Xto open the Fonnula Builder. 

NOTE Try to leave a blank row above functions that emit formulas. In-Sight prints descriptive 
labels above emitted formulas if it has room for the labels. If the row above is 
occupied, it emits only the numeric values, witfiout labels. 

b. From Vision Processing, open the Blob heading, and then open the ExtractBlobs property 
sheet. 

c. Select Region, click X, and interactively adjust the region of interest to surround the image of 
the part. 

d- Increase the Number to Find value to 4 and click OK to accept. ExtractBlobsQ extracts four 
blobs, stores them in a Blobs structure, and emits various formulas: 
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Calib object 
(stores a 

calibrated :::^iJ ^^■IV^to!>^^^tt*''■:ll'^ Fmittc^fl 

trAncfnrm^ ^^SS^i ^oan^ 73in;ia a^.^ I igigff- ii^ntm ?ei>jan: awiro gMM: rii ^tmiucu 

ii<iiis>iuiin| -^"V T^SST , tn'm^lyw^. - l,imi> :aflj«8, :4tMaaio ~2:pmf: a> -^fnrmulajc 

Blobs object 
(stores a 
blobs 
database) 

Region of 
interest 


4. Convert the feature data to World units: 

a. Skipping cell A7, move to cell A8 and click Xto open the Foimula Builder. From Coordinate 
Transforms, open Calibrate, select TransBlobToWorld. and click Xto open its property 
sheet. 

b. Click X on the Calib parameter, move the marquee to Al (the Calib structure), and click X to 
accept the reference. 

c. Click X on the Blobs, move the marquee to A3 (the Blobs structure), and click Xto accept 
the reference. 

d. Leave Num to Convert unchanged at 3. 

e. Click OK to close die property sheet. TransBlobToWorldQ applies the calibrated 
transfomiation fix)m Al to applicable values in A3- It stores a new Blobs structure in A8 to 
hold the converted values. It emits the changed values — in this case, the centroid Row and 
Column values: 






' - 1 



IndexH'" : 

■Row"'"" 


!•^3^ 




394366-1 i 
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'Image coordinates 


' World, coordinates 


World-to-pixel 
conversion 


Here, the first blob's centroid (indexed O.CKX)) was offset 280.328 pixels from the image row 
axis. In the calibrated World coordinate system, the same point is offset 60.880 millimeters 
from tiie World origin. 

Note that even though the original Blobs structure held four blobs, only three were converted. 
Also fvote that values such as Color and Score were not originally measured in image units. 
TransBlobToWoridO therefore did not convert them or generate the formulas that emit them. 
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5. Finally, convert one point back to its original pixel values: 

a. Move to All and click X to open the Fomiula Builder. 

b. From Coordinate Transforms, open Calibrate, select TransWorldToPixel. and click Xto 
open its property sheet. 

c. Click X on Calib, move tfie marquee to Al (the Calib structure), and click click Xto accept 
the reference. 

d. Click X on Point and move the marquee to C8 (the row value for blob 0, expressed in World 
coordinates). 

e. Click and hold O, click cursor Right to select the range C8:C9 (both the row and column 
values). 

f Release O, and then click X to accept the reference. Click OK to close the property sheet. 
Trans WorldToPixelO converts the row and column values from World coordinates back to the 
original pixel values. Bll should equal C3, and B12 should equal D3, showing that a 
calibrated transformation is reversible. 


^ ▲ ► Calibration: Understanding 


A calibrated transformation maps locations in physical space, as defined by a calibration plate> to locations in 
an image: 


Physical calibration plate Acquired image of 
(10 mm dot pitch) calibration plate 



Image coordirurte system 


Image point 

(7.0 pixels, 8.0 pixels) 

t I 

Transformation] 

— — 

Physical point 
(291 mm, 333 mm) 


Calibration makes it easier for you to define a coordinate system that is linked to the physical world. You 
typically establish a calibration when setting up an application, updating it if you change some aqject of the 
physical or optical setup. 


To perform a calibration, you acquire an image containing features that have known locations. You supply 
these locations to the Calibrate function in both coordinate systems. CalibrateQ then constructs a 
transformation that maps points between image (Pixel) coordinates and physical (World) coordinates in 
either direction. When choosing the calibration points, observe the following rules of thumb: 

• You can supply any convienient set of four points, provided you know their real-world locations. A 
grid-like arrangement is common but not required. The points cannot be collinear. 

• The calibrated setup must be identical to the production setup. Differences in optics, working 
distance, and other factors invalidate the calibration. 
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• As much as practical, keep the lens and the object in the same plane. In-Sight's four-point calibration 
tolerates skew, but eliminating perspective distortion in^roves accuracy. 

• As much as practical, keep the calibration plate square in the image. 

• Limit the calibration to the image region that contains the features of interest. For example, if the 
important features are in the iqjper-left quadrant, then place the calibration points at its perimeter. 

• Avoid extrapolating beyond the calibrated area. 

• The underlying matfiematics assume an ideal lens, without pincushion or barrel distortions. Lenses with 
significant geometric distortions reduce the accuracy of the calibration. 

After you create a calibration, you can use it to transfomi data emitted by vision functions into precise 
physical locations. 



^ A ► Fixtured Transforms: Getting Started 

A Fixture coordinate system is a reference coordinate system (X, Y, and theta) identified in an image and 
used to define other points or regions through offsets, typically to compensate for image-to-image variation in 
position, orientation, or both. With In-Sight, you can map a point from Fixture to Pixel coordinates in either 
direction with the TransPixelToFixture and TraiisFLxtureToPLxel functions. This topic describes how to use 
them. 

► To Create a Fixtured Transformation 

1 . Acquire an image. During development, you typically place a part sanple under the test stand and 
snap a picture of it Alternatively, to adjust the camera height, aperture, and focus, use live mode . 

2. Define a Fixture coordinate system — essentially an X, Y, and theta offset from the Pixel coordinate 
system. Any method that yields a ]X)int and angle is a potential source of a fixture. In a vision 
application, you commonly establish the fixture coordinate system in each image through a preliminary 
feature extraction step that finds a reliable landmaik in the image. For this exercise, you manually enter 
the values 10 in ceU Al, 20 in A2, and 45 in A3: 


'A2= 


I" A 

B 

C 

0 




1 

10.000 

20.000 

46.000 

~2 





3. From A2, open Fixture under Coordinate Transforms, and then open the TransFixtureToPLxel 
property sheet. 

4. On the property sheet, select the Fixture heading. By default, In-Sight assumes you want to select the 
fixture value by interactive reference. Move to cell Al and (holding down the O button) select the 
ceils Al, A2, and A3: 
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6. 


1, 


$A$1:$C$1 



Release O, and then dick X to accept. In-Sight returns to the property sheet, which shows 1 0 as the 
fixture row, 20 as the fixture column, and 45 as the fixture angle. 

From the property sheet, select the Point heading. Set the row value to 100 and the column value to 
200. 

Click OK to accept the fixture and point values. TransFixtureToPixelQ returns a Point structure that 
stores the Pixel row and column values. As a convenience, it also emits the row and column values to 
the adjacent cells: 



A 

B 

C 

D 


; , 0 

^Image 





: 1 

10.000 

20.000 

45i)00 



; 2 

1 ^Points 

-60.711 

232.132 




Other fimctions that depend on the translated point values can refer to the Point structure or the 
emitted values to obtain them. 
8. To translate a point in Pixel coordinates to Fixture coordinates, open the TraasPixelToFixture 
property sheet and specify a fixture and point through the techniques described above. 
TransPixelToFixtureO similarly returns a Point stmcture and emits row and column values: 


A3= TransRxelTorDfture($A$1,$^1,$C$1 joq^ 



A 

B 

C 

D 


0 

^Image 





\ 1 

10M) 

20.000 

45iI00 



^ 2 

QjPoints 

-€0.711 

2^i32 



3 

1 ^Poinls 

»t!JiKji:MM,l6i:gFiJ 


f 


COGIMEX In^Sighf^ 


^ A ► Warp Transforms: Getting Started 

A waiped coordinate system is the result of mapping a curved region into a rectangular image space. With 
In-Sight, you can map a point fiom a waiped image back to the equivalent point in the original unwarped 
unage. This topic describes how to create a warped image and how to translate a point in the warped image 
back to the unwarped image. 

^ To Warp an Image and Map a Point from It 
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2. 


Acquire an appropriate image. For this exercise, a coin that has text printed around its perimeter 
makes a good sample image: 

a. Place the coin under the camera. 

b. Chck and release ^S, select Live fiom the System menu, and dick X to enter iive mode. 
Interactively adjust the image location, camera height, aperture, and focus until satisfied with the 
unage. The miage should have good contrast without shadows, reflections, or other imaee 
defects. & 

c. Click A twice to exit live mode, acquire the last image, and rettim to the woiicsheet 
To acquire a new image, hold □ and click X. 

Create a waiped image of the coin, attempting to "straightoi out" text printed around its perimeter: 

a. From ceU Al, click Xto open the Fomiula Builder. From Vision Processing, open the 
Image heading, and then open the Warplmage property sheet. 

b. Click the Region heading. In-Sight dravi^ the interactive region cursor on the image. Clicking 
O cycles the cursor to set location, size, angle, or curvature: 


Position 


Size 


Angle 


64 


^247- Col 


Curve 


Row 



High 


Degrees CCW 


\ / 


w — ^ 

Degrees Curvature 

Move the center of the Region Cursor to the center of the region; dick Oand resize the region- 
click O and set the angle (if any); and click O again and set the curvature. The result should 
look about like this: 



d. Click X to accept the curved regioa In-Sight returns to the property sheet. 
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Click OK to accq5t the input values. WaiplmageO warps the curved region into a new 
rectangular iniage. stored in an Image stiiicture . In-Sight displays the warped image whenever 
you fly over the Image structure containing it 



Any function that accepts an Image structure as an image source can refer to the warped image 
in lieu of the acquired image, simply by changing its Image reference from $A$0 to the cell 
containing the warped image. 


3. Translate a point in the warped image back to equivalent point in the image: 

a. From cell A2, click Xto open the Formula Builder From Coordinate Transforms, open the 
Calibrate heading, and then open the TransWarpToPixel property sheet. 
Click the Warplmage parameter. In-Sigjit switches to interactive reference mode. Move the 
marquee to Al and click X, creating a reference to the warped image. 

I>efine a point in the warped image for translatioa One method is to expand the Point heading 
in the Trans WaipToPixel property sheet and directly edit the values. Another (shown below) is 
to put the values in cells and then refer to them. 

Click OK to accept the input values. TransWarpToPixelO translates the point from w^aiped 
image back to the unwarped image, returning a Point structure and emitting its row and column 
values: 


b. 


d. 


Acquired image 
Warped image- 



Point in v/arped 
m image 


Unwarped poim 
g (emitted results; 


► Coordinate Transforms Reference 


Calib structure 
Calibrate 

TransBlobToWorld 
TransDistTo World 


Stores a calibrated transformation. Created by CalibrateO- 

Creates a calibrated transformation between Pixel and World coordinates, given four 
points in both systems. Stores the transform in a Calib structure. 
Applies a calibrated transformation to a Blobs structure. Returns a new Blobs 
structure translated to World coordinates. 

Applies a cahbrated transformation to a Dist structure. Returns a new Oist structure 
translated to World coordinates. 
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TransEdfieToWorld Applies a caUbrated transformation to an Edges structure. Returns a new Edges 

structure translated to World coordinates. 
TransFixtiireToPixej Converts a point in Fixture coordinates to Pixel coordinates. Returns a Point 

structure. Emits the Pixel coordinates. 
JransPattemsToWorld Applies a calibrated transfomiation to a Patterns structure; Returns a new Patterns 
structure translated to World coordinates. 

Converts a point in Pixel coordinates to Fixture coordinates. Returns a Point 
structure. Emits the Fixture coordinates. 

Converts a point in Pixel coordinates to World coordinates. Returns a Point 
structure. Emits the World coordinates. 

Maps a point in a warped image back to the original, unwarped image. Returns a 
Point structure. Emits the Pixel coordinates. 

Converts a point in World coordinates to Pixel coordinates. Returns a Point 
structure. Emits the Pixel coordinates. 


TransPixelToFixture 
TransPixelToWortd 
TransWarpToPixel 
TransWorldToPixel 


In^^ight) 


^ A ► Calib structure 


Etescription 
Values 

Comments 


See Also 


Stores a calibrated transformation. Created by CalibrBteQ. 

Calib has no internal values that are read individually by Data Access functions. It stores a 
cabbration on behalf of other functions requiring one. 

The Calibrate function creates a calibrated transfomfiation and stores it in a Calib structure. 
Functions that refer to a Cahb structure to obtain calibration data are TransBlobToWnrlH, 
TransEdseToWorld, TransPixelToWorid. TransPattemsToWorld. and 
Trans WoridToPixel 
Calibrate 


^ A ► Calibrate function 


Descnption Creates a calibrated transformation between Pixel and Worid coordinates, given four 

points in both systems. Stores the transform in a Calib structure. 
Heading Coordinate Transforms/Cahl)rate 

Syntax Calibrate(Pixel Point 0, World Point 0, Show) 

Inputs Pixel Point 0 The image pixel conesponding to Worid Point 0. Row and column 

oflfeets fix)m the image origia 


— Row 
— Column 
World Point 0 
—X 
— Y 

Pixel Point 1 

Row 


The real-worid point corresponding to Pixel Point 0. X and Y 
coordinates. 

The image pixel corresponding to Worid Point 1 . Row and column 
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— Column 

Worid Point 1 The real-world point corresponding to Pixel "Point 1 . X and Y 
— X coordinates. 
— Y 

PixelPoint 2 The image pixel conesponding to Worid Point 2, Row and column 
— Row offsets fix)m the image oiigin. 

— Column 

Worid Point 2 The real-world point corresponding to Pixel Point 2. X and Y 
— ^X coordinates. 
— Y 

Pixel Point 3 
— Row 
— Column 

Worid Point 3 The real-world point con^esponding to Pixel Point 3. X and Y 
— ^X coordinates. 
— Y 

Show Selects the graphics to display, as described in Flyover Graphics : 


The image pixel corresponding to World Point 3. Row and column 
offsets from the image origin. 


• Hideall 

• Result gr^hics only 

• Iiput and result gr^hics 

• Show all, which displays input, result, and chart (if any) graphics. 

Stores Callb On success, a Calib staicture, v^^ch stores the calibrated transformation. 

Emits Nothing. 

Errors Invalid world-to-pixel association. For example, the points are colinear. 

Comments None. 

See Also TiansPixelToWorld. TransWorldToPixel. Getting Started with Catibration . 


^ A ► TransBIobTo World function 


Description 

Heading 

Syntax 

Inputs 


Stores 


Applies a calibrated transformation to a Blobs stnictiire . Returns a new Blobs smicture 
translated to World coordinates. 
Coordinate Transforms/Calibrate 
TransBlobToWorld(Calib, Blobs, Num to Convert) 


CaKb 
Blobs 

Num to 
Convert 
Blobs 


Reference to a Calib structure, frran Calibrate . 

Reference to a Blobs stmcture, from ExtractBlobs. FindBlobs. or 

SortBlobs . 

The number of blobs to convert. 

On success, a Blobs structure, with coordinates in World units. 
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Emits 


Errors 
Comments 


See Also 


Index Zero-based index into the Blobs structure. 

Row Centroid X coordinate, in World units. Read by GetRow . 

Col Centroid Y coordinate, in World units. Read by GetCol . 

Invalid parameter. 

A Blobs structure stores a database of blobs extracted from an image. Each blob has a 
zero-based index and a set of measured values. When first created, many of these values 
are in image coordinates. TransBlobToWorldQ converts all of the applicable values in one 
step, returning a new Blobs stnicture with coordinate values (Row, Column, ??and 
Angle??) in World units. Non-coordinate values (Area, Blob Color, Elongation, Holes, 
Number Found, Perimeter, Score, and Spread) pass through unchanged. 
Blobs structure, Calib structure. Calibrate function. Calibration: Converting Valups: . 


► TransDistTo World function 


Description 

Heading 

Syntax 

Inputs 

Stores 
Emits 


Errors 
Comments 
See Also 


Applies a calibrated transformation to a Dist stmcture . Returns a new Dist structure 
translated to World coordinates. 
Coordinate Transforms/Calibrate 
TransDistToWorld(Calib, Dist) 

Reference to a Calib stmcUire. frc«n Calibrate . 
Reference to a Dist structure. 

On success, a Dist structure, with coordinates in World units. 
Zero-based index into the Dist structure. 
First end point, X coordinate, in World units. Read by GetRow . 
First end point, Y coordinate, in World units. Read by GetCol . 
Second end point, X coordinate, in World units. Read by GetRow . 
Second end point, Y coordinate, in World units. Read by GetCol . 
The measured distance between the two end points. Read by GetPistance . 
Angle value, in counterclockwise degrees. Read by GetAnglc . 
Invalid parameter. 
None. 

Dist strucuire, Calib structure. Calibrate fiinction. Calibration: Converting lvalues' . 


Calib 
Dist 
Dist 
Index 
RowO 
ColO 
Rowl 
Coll 
Distance 
Angle 


^ A ► TransEdgeTo World function 
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Description 

Heading 

Syntax 

Inputs 


Stores 
Emits 


Applies a calibrated transformation to an Edges structure . Returns a new Edges structure 
translated to World coordinates. 
Coordinate Transforms/Calibrate 
TransEdgeToWorld(Calib, Edges, Nam to Convert) 


Reference to a Calib structure, from Calibrate . 

Reference to an Edges structure. 

Number of edges to convert to World coordinates. 


CaUb 
Edges 
NuRi to 
Convert 

Edges On success, an Edges structuie, with coordinates in World units. 

The exact values depend on the type of edges. For straight-line edges;, the emitted values 

are: 


Errors 
Comments 


See Also 


Index Zero-based index into the Edges structure. 

RoivO First end point, X coordinate, in World units. Read by GetRow . 

ColO First end point, Y coordinate, in World units. Read by GetCol . 

Rowl Second end point, X coordinate, in World units. Read by GetRow . 

EndCol Second end point, Y coordinate, in World units. Read by GetCol . 

Score The edge score, 0.00 to 100.00. This value does not change because it is 

not a coordinate. Read by GetScore . 
Invalid parameter. 

An Edges structure stores a database of edges extracted from an image. Each edge has a 
zero-based index and a set of measured values. When first created, many of these values 
are in image coordinates. TransEdgeToWorldQ converts all of the applicable values (the 
row and column coordinates) in one step, returning a new Edges structure with 
coordinates in Worid units. Non-coordinate values (score) pass through unchanged 
Calib structure. Calibrate function. Edges stnjcture . 


M A ^ TransFixtureToPixel function 


Description 

Heading 

Syntax 

Inputs 


Converts a point in Fixture coordinates to Pixel coordinates. Returns a Point structure. 
Emits the Pixel coordinates. 
Coordinate Transforms/Fixture 
TransFixtureToPixel(Fixture, Point) 


Stores 


Fixture 
— Row 
— Column 
— Theta 

Point 
—X 
— Y 
Pwnt 


Fixture origin, defined by row, column, and angle offsets, typically to 
compensate for image-to-image variation in position, orientation, or both. 
Row and Column are offsets, in pixels from the image origin. Theta is a 
rotation from the image row axis, ± 360° CCW. Defaults all 0 (the image 
origin). See Working^ with Fixtures . 
A point, defined by X and Y offsets from the Fixture origin. 


On success, a Point stmcture. which stores the points. 
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Emits 


Row 
Col 


Row coordinate, in Pixel units. A pixel offset iSrom the image origin. Read 
by GetRow . 

Column coordinate, in Pixel units. A pixel oflfeet fiom the image origin 
Readbv GetCol . . 
Errors Invalid parameter. 

Comments None. 

See Also TransPixelToFixture, Getting Started with Fixture Trans forms. 


\ 


^ A ► TransPatternsTo World function 


Description 

Heading 

Syntax 

Inputs 


Stores 
Bnits 


Errors 
Comments 


See Also 


Applies a calibrated transformation to a Panems stnicnire . Returns a new Patterns 
structure translated to Worid coordinates. 
Coordinate Transforms/Calibrate 

TransPattemsToWorld(Calib, Patterns, Num to Convert) 


Calib 
Patterns 
Num to 
Convert 
Patterns 
Index 
Row 
Col 
Angle 


Reference to a Calib sft-ucture. from Calibrate . 
Reference to a Patterns structure. 
The number of matched instances to convert 


Scale 


Score 


On success, a Patterns structure, with coordinates in World units. 
Zero-based index into the Patterns structure. 

X coordinate of the reference point, in Worid units. Read by GetRow . 
Y coordinate of the reference point, in Worid units. Read by GetCol. 
Angle of instance, in counterclockwise degrees relative to the model, 
converted to World units. Read by GetAngle . 
Scale of the instance, as a percentage of model. Not changed by the 
transfoim because it is not a coordinate. Read by GetScale . 
Score of the instance. Not changed by the transform because it is not a 
coordinate. Read by GetScore . 
Invalid parameter. 

A Patterns structure stores a the matched instances extracted from an image. Each 
instance has a zero-based index and a set of measured values. When fu^t created, many 
of these values are in image coordinates. TransPattemsToWorldQ converts aU of the 
^plicable values (Row, Column, and Angle) in one step, returning a new Patterns 
stmcture witfi coordinates in World units. Non-coordinate values (Number Found, Scale, 
and Score) pass through unchanged. 
Calib structure. Calibrate fimction. Patterns structme . 


^ A ► TransPixelToFixture function 
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Description 

Heading 

Syntax 

Inputs 


Stores 
Emits 

Errors 
Comments 
See Also 


Converts a point in Pixel coordinates to Fixtxire coordinates. Returns a Point structure. 
Emits the Fixture coordinates. 
Coordinate Transfomns/Fixture 
TransPixelToFixture(Fixture, Point) 

Fixture Fixture origin, defined by row, column, and angle offsets, typically to 
— Row compensate for image-to-image variation in position, orientation, or both, 
— Coiumr Row and Cohunn are offsets, in pixels fiom the image origin. Theta is a 
— Theta rotation finom the image row axis, ± 360° CCW. Defaults all 0 (the image 
origin). See Working with Fixtures . 

A point, in Pixel coordinates (row and column offsets from the image 
origin). 


Point 
— Row 
— Column 
Point 
Row 
Col 

InvaUd parameter. 
None. 

TransFixtureToPixel. Getting Started with Fixture Transforms 


On success, a Point structure, which stores the points. 
X coordinate, in Fixture units. Read by GetRow . 
Y coordinate, in Fixture units. Read by GetCol . 


^ A ► TransPixelToWorld function 


Description 

Heading 

Syntax 

Inputs 


Stores 
Emits 

Errors 
Comments 
See Also 


Converts a point in Pixel coordinates to World coordinates. Returns a Point structure. 
Emits the World coordinates. 
Coordinate Transforms/Calibrate 
TransPixelToWorid(Calib, Point) 

Calib Reference to a Calib structure, from Calibrate . 

Pmnt A point, in Pixel coordinates (row and column oflfeets from the image 

— Row origin). 
— Column 
Point 
Row 
Col 

Invalid parameter. 
None. 

Calibrate. TransPixelToWorld TiansWoridToPLxel 


On success, a Point structure, which stores the points. 
X coordinate, in World units. Read by GetRow . 
Y coordinate, in World units. Read by GetCol . 


A ► TransWarpToPixel function 
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Description 

Heading 

Syntax 

Inputs 


Stores 
Emits 


Errors 
Comments 
See Also 


Maps a point in a waq>ed image back to the original, unwarped image. Retums a Point 
structure. Emits the Pixel coordinates. 
Coordinate Transforms/Warp 
TransWarpToPixeI(Image, Point, Show) 

Image A waiped image. A reference to an Image structure created by 

Warplmage . NOT the default image stored in $A$0. 
A point in the warped image. 


Point 
— Row 
— Column 
Show 


Selects the graphics to display, as described in Flyover Graphics : 

• Hideall 

• Result graphics only 

• Input and result graphics 

• Show all, which di^lays input, result, and chart (if any) graphics. 


Point 
Row 


Col 


On success, a Point stmcture. which stores the points. 
Row coordinate, in Pixel units. A pixel ofi&et fix>m the image origin. Read 
by GetRow . 

Column coordinate, in Pixel units. A pixel ofifeet fiom the image origin. 
Read by GetCol . 
Invalid parameter. 
None. 

Warolmage. Getting Started with Warp Tramfonns . 


^ A ► TransWorldToPixel function 


Description 

Heading 

Syntax 

Inputs 


Stores 
Emits 


Errors 
Comments 


Converts a point in Worid coordinates to Pixel coorxdinates. Stores a Point structure. 
Emits the Pbcel coordinates. 
Coordinate Transforms/Calibrate 
TransWorldToPixel(Calib, Point) 


Calib 
Point 
—X 
— Y 
Pcrnit 
Row 


Reference to a CaJib structure, fiom Calibrate . 

A point, defined by X and Y offsets from the Worid origin. 


On success, a Point stnicture. which stores the points. 
Row coordinate, in Pixel units. A pixel offset from the image origin. Read 
by GetRow . 

Column coordinate, in Pixel units. A pixel offset from the image origiiL 
Read by GetCol . 
Invalid parameter. 
None. 


Col 
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See Also Calibrate. Trans PixelTo World 
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^ A ► Edge: Overview 

Edge detection is a feature extraction technique for finding single edges or edge paiis in an image Each edge 
IS marked by a change in the grayscale value of neighboring pixels fh)m li^t-to-daric or dark-to-lidit This 
change might span several pixels. 

This section describes ,In-Sight*s Edge functions, located under Vision Processing, which offer your 
application data about the number, location, shape, and orientation of edges. It discusses the foUowine 
topics: ^ 

• Getting Started with Edge Detection 

• Understanding Edge Detection 

• Edge Reference. 

ln-Sight*s Edge fiinctions offer methods of filtering felse (noise-induced) edges and excluding uninteresting 
edges. They also provide methods for sorting them in various orders. 


Insight; 


^ A ► Edge: Getting Started 

Hiis topic introduces edge detection. It uses the FindLineO function, which detects straight-line edges as an 
example to show the basic procedures. Other Edge fimctions detect curved, circular, or multiple edge^ using 
through similar sequences of steps. o & 

► To Detect an Edge 

1 . Acquire an appropriate image. For this exercise; 

a. Open the part sample image, print it, and return to this topic. Place the printed image under the 
camera. 

b. Click and release A, select Live from the System menu, and click X to enter live mode. 
Interactively adjust the image location, camera height, aperture, and focus until satisfied with the 
image. 

c. Chck A twice to exit live mode, acquire the last image, and return to the worksheet 
To acquire a new image, hold □ and click X. 

2. From an empty ceil, click X to open the Fonnula Builder . 

NOTE Try to leave a blank row above functions that emit formulas. In-Sight prints descriptive labels 
above emitted formulas if it has room for the labels. If the row above is occupied, it emits 
only the numeric values, without labels. 

3. From the Vision Processing category, select Edge, and then open the FindLine property sheet 

4. To define region of interest, select the Region head and clickX. In-Sight hides the worksheet and 
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displays the Region cursor, which you interactively adjust with the Control Pad. When detecting 
edges — which can be black-to- white or white-to-black transitions — In-Si^t indicates the region's 
scanning direction with arrowheads along two edges: 


Center column 
Center row 


In the orientation shown, FindLineQ interprets edge polarity from lefl-to-right or from top-to-bottom. 
5. Outline an image area containing one or more edges, and then click X to accept the region, returning 
to the FindLineQ property sheet. At the bottom of the property sheet, In-Sight draws an edge- 
strength graph on the image: 



To view only the edge-strengh graph and image, click A to toggle the property sheet overlay ON or 
OFF. 

6. In the FindLineQ property sheet, set the parameters that define edge characteristics: 

o Polarity, either white-to-black or black-to-white, 
o Find By, xxx 

o Accept Threshold, the minimum accq^table edge score. Linear features scoring below this 

level are.rejected. 
o Angle Range, 

o Edge Width, the minimum edge width, in pixels. 

7. After you set appropriate parameters, either: 

o Click Run to extract edges without closing the property sheet, 
o Click OK, to extract edges and close the property sheet. 

FindLineQ analyses the image for edges that fit the selection criteria, stores an Edges structure 
containing the edges, and &mts various results: 


1 

11J)00 

RowO 

CdO 

Rowl 

Coil 

Score 

2 

^Edges 

162^ 

320.841 

181^00 

320 J41 

-10349 


Each Edge has a zero-based index and a set of measured values. You use the indexes to refer to a 
particular edge in the Edges structure. 


Direction of polaritv 
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To use a result value in a formula, simply create a referaice to its cell. If you don't need one of the 
automatically generated resuh cells, you can delete it 

8. You can experiment with different selection criteria by changing their values and clicking Run again. 
Restrictive values tend to yield fewer edges, and relaxed values tend to yield more edges. 

9. By defeult, bi-Sight displays the edge graphics only when you highlight the Edges stnjcture, as 
described in FIvover Graphics. To display the Edge graphics all the time, set the FindLineQ 
fiinction's Show parameter to Show AD. 



^ A ► Edge: Understanding 

Edge analyzes images in two stages: 

1 . Projection, which maps a two-dimensional window of an image (the edge window) into a one- 
dimensional image. Projection collapses an image by summing the pixels in each line along the 
direction of the projection, and then taking the first derivative of the line represented by these sums. 
This technique tends to amplify edges along the axis of the projection. 

2. Filtering, which subjects an image projection to constraints that eliminate the minor changes in 
grayscale values likely to be the result of image noise. After filtering, the results that remain significant 
are considered closest to the tme edges in the image. 

The following topics tell you how use edge 

• Defining an ROl 

• St>ecifidng Edge Features 

• Specifiving Edge Filter Parameters 

• Setting the Acceptance Threshold 

• Specifying the Extract Method 

• Specif/ing the Sort Order 

• Finding Edges 

• Measuring Edges . 


— — — — = — COGMEX ln(3lgh^ 

^ A ► Edge: Defining the ROI 

When you open the Region heading fiom an Edge fimction, In-Sight draws a rectangular outline called the 
region cursor over the image. The region cursor indicates region of interest and lets you move and rotate it 
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with the Control Pad, as described in Deflnins^ a Region of Interest , 

An edge is a transition from black-to-white or white-to-black — an attribute called polarity. When defining 
the properties of an edge, you can specify the polarity to detect. Transitions that don't have the right polarity 
aren*t edges. Polarity depends on direction, however. An edge that is white-to-black in one direction is 
black-to- white in the opposite direction. The region of interest therefore has a detection direction, indicated 
by arrowheads on two sides of the region cursor: 


Center column 
Center row 


Ideally, the x-axis of the region cursor should be perpendicular to the edges you expect to find. Assuming the 
base point is at the upper left of the region cursor, the search for edges starts at the left side of the region and 
progresses to the right side. Edge finds all edges perpendicular to the region cursor's angle of rotation, 
subject to the search criteria you have selected: 


Direction of edge detection 





Edges found 
perpendicular to ---...^^^^ 
detection direction 







This relationship is the same regardless of how the region cursor is rotated. 



^ A ► Edge: Specifying Features 

The Feature section, in the i^per-left comer of the Edge dialog, contains controls that determine the type of 
edges sougjit Its has four fields: FirstPolarity, ExpectedWidth, Tolerance, and Second Polarity. 

FirstPolarity sets the expected grayscale progression for edges: dark-to-light, light-to-dark, or either. By 
default, FirstPolarity is zero, indicating "either." 

ExpectedWidth sets the number of pixels expected between edge pairs. It is also zero by default — which 
configures Edge to seek single edges, not edge pairs. Changing ExpectedWidth to a positive value other than 
zero configures Edge to seek edge pairs separated by the specified number of pixels. 


Direction of polarity 
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Setting ExpectedWidlh enables the Tolerance field, where you specify the number of pixels of deviation from 
the ExpectedWidth value. It also enables the Second Polarity list, where you specify a polarity for the last 
edge in the pair. 

Second Polarity includes an option (in addition to the ones in FirstPolarity) called SolidBar. SolidBar, v/hm 
set, ensures that edge pairs enclose an area that does not change color. For example, if the leading edge in 
such a pair is light-to-dark, the trailing edge v.'ill be the first dark-to-hght progression afterward along the 
edge detection direction. The resulting pair would then enclose a solid (in tfiis case, daiic) bar. 


1 



^ A ► Edge: Filtering Edges 

After projection. Edge applies an edge filter to the resulting one-dimensional image. The edge filter 
accentuates edges in the image and produces a filtered image. The Operator section lets you specify two 
filtering parameters, Noise Size and Leniency. 

Size (or Noise Size) determines the number of adjacent points considered in the derivation of the one- 
dimensional representation. For each point in the line, the derivation includes the specified number of 
adjacent points on each side of the point The higher the setting, the higher the contrast required in the imag 
to avoid being "smoothed out" in the derivatioa 

Leniency ^ifies the number of pixels to ignore at an edge in the image. Due to slight changes in edge or 
edge-pair position or orientation, a pixel on the edge of a feature might not always have the same grayscale 
value in each acquired image at mn time. Setting a leniency zone between the li^t and daric areas of a 
feature minimizes the effects of slight changes in feature location on edge filter results. 



^ A ► Edge: Accept and Num to Find 

The Accept value gjecifies the acceptance threshold— the lowest score that is a valid edge. Features widi 
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lower scores are rejected as edges. Scoring depends on the grayscale difference between two adjacent 
edges. These grayscale values are nonnalized so that 0 is black and 100 is white. The contrast score is the 
difference between them. Therefore, the highest possible score is 100, and the lowest is 0. When you set the 
Accept threshold, you are determining the largest grayscale difference that may be discarded as a possible 
edge. 

N2Find allows you to set the maximum number of edges to find. ?? immediately stops looking for edges 
after it finds N2Find edges that exceed the acceptance threshold. It might or might not find the specified 
number. 


^ A ► Edge: Extract Method 

After youVe specified the appropriate filtering operator, you can ^)ecify which edges to find when you click 
Find or Run(Find). The Extract menu gives you a choice between accepting the Jirst edges found, halting 
evaluation as soon as it reaches N2Find, or the best edges found, evaluating the entire window and then 
selecting the highest scores. In either case, all results must pass the Accept threshold to be reported as 
edges. 

By default, if you specify a smaller number of edges in N2Find than actually exist in the image, the 77? 
fiinction wiU report a number edges equal to N2Find in the order they appear in the edge detection direction. 
In this case, the result is already sorted by Offset. If you choose to extract by score, all of the edges found 
over the entire width of the region will be evaluated If the number of edges found exceeds N2Find then only 
the best N2Find edges are reported. In this case, the order of the results is undefined. 



^ A ► Edge: Specifying Sort Order 

Before your object has found edges, you can arrange to sort them by any of the values mentioned in the 
report. To sort the edges in the order you desire, choose your method from the Sort list. Later, when you 
instruct the object to display the edges it found, they will appear sorted in the order you specified. 

The Sort list lets you specify the criterion for sorting the edges: 

• 0: Unsorted. 

• 1 : Offset distance, in pixels, fix>m the focal point. 

• 2 : Scores (contrast values). 

• 3: X positions, in pixels, relative to the origin point. 

• 4 : Y positions, in pixels, relative to the origin point 
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• 5: Widths, in pixels. 

• 6: Delta widths— that is, the change in width relative to the previous edge*s width. 

• 7: Positive polarity firet, negative polarity last. 

• 8: Negative polarity first, positive polarity last 



^ A ► Edge: Finding Edges 

Fmd first identifies edges, according to the one-dimensional, derived, filtaed image. It next sorts the found 
edges according to the Sort selection and rqjorts the results in the Result ar^ in the bottom of the dialog 
box. FmaUy, it reports the number of edges found in the NFound field and their locations, scores, and other 
results in the Result list: 


The Result for each edge found contains a series of values, representing the grid coordinates of the edge in 
relation to the region and to the image at large. These values are described below, as they appear fix>m left to 
n^t: 

• Index: A number by which to refer to any particular found edge among the others. 

. X: The X-axis coordinate of the found edge, measured in pixels from tfie origin of the entire image 

• Y : The y axis coordinate of flie found edge, measured in pixels ftom the origin of the entire image 

• Offset: The offset (in pixels) fix)m the focal point of the scan regioa 

• Width: The width in pixels of the edge pair, if applicable. 

• difference in grayscale at the edge, measured in incremental shades of gray fiom 0.00 to 

• PI: The polarity of the first edge, expressed as -1 (light to daric progression), 1 (dark to light 
progression) or 0 (either progression). 

• P2: The polarity ofthe second edge, if applicable. 


^ A ► Edge: Measuring Edges 


???^ additional button in the Edge stnicture dialog. World, allows measurements for offset, x coordinate y 
coordinate, and width to show in either pixels or real-world units of measurement If you click on World to 
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choose world measurements, the button changes to "Pixel" to toggle back to pixels, and vice versa. Use a 
calibrated transformation to convert to world measurements as necessary. 


7 


^ A ► Edge: Function Reference 


Edges strucuire Stores a database of edges, each with a zera based index and a profile of measured 
values. Coordinates in Image units (pixels) unless converted by TransEdgeToWorld . 

FindCircle Finds the best circular edge. Returns an Edges structure. Emits the center row, center 

column, and radius. 

FtndCurve Finds the best curved edge. Returns an Edges structure. 

FindLinc Finds the best straight-line edge. Returns an Edges structure. 

FindMultiLine Finds multiple straight-line edges. Returns an Edges structure. 

FirxiSetmient Finds an edge pair defined by a black or white segment Returns an Edges structure. 
Emits the two edges. 

PairPistance Returns the distance between a pair of edges. 

PairEdges Groups multiple edge results into pairs. Returns an Edges structure. 

PairMax Distance Returns the maximum distance between multiple edge pairs. 

PatrMeanPistanceR etums the mean distance between multiple edge pairs. 

PairMin Distance Returns the minimum distance between multiple edge pairs. 

PairSPevPistance Retums the standard deviation of the distances multiple edge pairs.. 

SortEdges Sorts an Edges structure by specified criteria. Stores a new, sorted Edges structure. 

TransEdgeToWorld . under Coordinate Trarisforms, converts edge results to World coordinates. Results 
functions, under Data Access, that get results fix>m an Edges structure are GetCol. GetNFound, GetRadius. 
GetRow\ and GetScore. 


^ A ► Edge: Edges structure 


Description 
Values 


Stores a database of edges, each with a zero-based index and a profile of measured 
values. Coordinates in Image units (pixels) unless converted by TransEdaeTo World . 


Value 
Index 


Column 

NFound 
Radius 


Description 

Index identifiying a particular edge. Zero-based, so 
the first edge is indexed 0.00, the second is indexed 
1 .00, and so on. 

???. In pixels unless converted by 

TransEdgeToWorId(). 

Number of edges ?or edge pairs? stored. 

???. ??AIways in pixels, even if the Edges structure 

is converted to World units. 


Access function 


GetCol 

GetNFound 
GetRadius 
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Coininents 
See Also 


Row ???. In pixels unless converted by 

TransEdgeToWorldQ. 
As computed by ??, 0.00 to 100.00. 


Score 

None. 

FindCircle, FindCiirve, FindLine. FindMultiLine. PairEdges. FindSegnient 
TransEdgcTo World. SortEdges . 


GetRow 
GetScore 


M A ► Edge: FindCircle function 


Description 

Heading 

Syntax 

Inputs 


Finds the best circular edge, returning an Edges structure. Emits the center row, center 
column, and radius. 
Vision Processing/Edge 
FindCircle(Image, Fixture, Torus, Show) 


Image 
Fixture 
— Row 
— Column 
— ^Theta 

Torus 
—X 
— Y 
— Inner 
— Outer 
Polarity 

Find By 


Accept Thresh 
Edge Width 
Show 


Stores 


Edges 


Image data source, a reference to an Image structure . Default is $A$0. 
Fixture origin, defined by row, column, and angle offsets, typically to 
compensate for image-to-image variation in position, orientation, or 
both. Row and Column are offsets, in pixels fiom the image origin, 
Theta is a rotation fiom the image row axis, ± 360^ CCW. Defaults all 
0 (the image origin). See Working with Fixtut fis 
Region of interest X and Y define the center of the tonis by offsets 
fiom the Fixture origin. Inner radius is the radius of the inner circle, in 
pixels. Outer radius is the radius of the outer circle, in pixels. 

Expected grayscale transition, evaluated from the inside to the outside. 
One of: either, black-to-white, or white-to-black 
Criterion for selecting circular edges. One of: 

best score 
smallest circle 
largest circle. 

Acceptance threshold, a minimum score, 0 through 100. 
Expected transition width, in pixels. 

Selects the graphics to display, as described in Flyover Gra phir^- 

• Hide all 

• Result gr^hics only 

• Input and result graphics 

• Show aU, wiiich di^lays input, result, and chart (if any) gr^hics. 

On success, an Edtres stmcture. which stores the edge results. ??Should 
store a Circle, not an Edges structure?? 
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Emits 


Errors 
Comments 
See Also 


centRow The row coordinate of the center point. Read by GetRow . 

centCol The column coordinate of the center point. Read by GerCol . 

radius The radius of curvature, in pixels. Read by GetRadius . 

score The edge score, 0.00 to 1 00.00, a floating-point value. Read by 

GetScore . 

Invalid parameter. 
None. 

FindCurve. FindLine, FindMultiLine. PairEdges. PairPistance. PairMaxDistance. 
PairMeanPistance, PairMinPistance. PairSDevDistance. FindSe^ment, SortEdges. 
TransEdgeTo World 


A ► Edge: FindCurve function 


Pescription Finds the best curved edge, returning an Edges structure. ??JM thinks this should not 

return an Edges. Suggested TBP. 
Heading Vision Processing^dge 

Syntax FindCurve(Image, Fixture. Region, . . , , Show) 

Iiiputs Image Image data source, a reference to an image structure . Pefault is $A$0. 

Fixture Fixture origin, defined by row, column, and angle offsets, typically to 

— Row conrq>ensate for image-to-image variation in position, orientation, or 

— Column both. Row and Column are oflfeets, in pixels fiom the image CMigin. 
— ^Theta Theta is a rotation from the image row axis, ± 360° CCW. Pefaults all 

0 (the image origin). See Workinn with Fixtures . 
Region Region of interest. X and Y define the top-lefl point by oflfeets from the 

— Fixture origin, in pixels. High and Wide are the height and width, in 
— V pixels. Angle is a rotation from the Fixture X axis, ± 360*^ CCW. 

— High Curve is the angle between the sides of the region, ± 360** CCW). For 

— Wide curved regions, '^vidth" is the arc distance at the center of the region. 

— ^Angle See Definins^ a Region of Interest . 

— Curve 

Polarity Expected grayscale transition, evaluated from the inside to the outside. 

One of: either, black-to- white, or white-to-black. 
Find By Criterion for selecting circular edges. One of: 

• best score 

• closest to Y axis (the tojvmost, unless the Region is "upside 
down'O 

• farthest from Y axis (the bottonvmost, unless the Region is 
"upside down") 

Accept Thresh Acceptance threshold, a minimum score, 0 through 100. 
Angle Range Angular tolerance, ± 0 to 10 degrees. 
Edge Width Expected transition width, in pixels. 

.Show Selects the pranhias tn difw^lav. as described in Fivnvr.r Grnnhir.K: 
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Emits 


Stores 
Errors 
Comments 
See Also 


centRow 

CentCol 

StartRow 

StartCol 

EndRow 

EndCol 

Radius 

Score 


• Hideall 

• Result gr^hics only 

• Input and result graphics 

• Show all, which di^lays input, result, and chart (if any) graphics. 

The row coordinate of PointO, the center point. Read by GetRow . 
The column coordinate of PointO, the center point. Read by GetCol . 
The row coordinate of Point 1 , the first point Read by GetRow . 
The column coordinate o:'PointI , the first point Read by GetCol . 
The row coordinate of P<>int2, the end point Read by GetRow . 
The column coordinate of Point2, the end point Read by GetCol . 
The radius of curvature, in pixels. Read by GetRadius . 
The edge score, 0.00 to 100.00, a floating-point value. Read by 
GetScore . 

On success, an Edges structitre, which stores the edge results. 


Edges 

Invalid parameter 
None. 

FindCircle, FindLine, FindMultiLine. PairEdges, PairPistonce. PairMax Distance, 
PairMeanPistance , PairMinPistance. PairSDevDistance. FindSeement SortEdges 
TransEdgeToWorid 


^ A 


► Edge: FindLine function 


Pescription 
Heading 
Syntax 
Inputs 


Finds the best straight-line edge, returning an Edges structure. 
Vision Processing/Edge 
FindLine(Image, Fixture, Region, . . ., Show) 


Image 
Fixture 
— ^Row 
— Column 
— Theta 

Region 
—X 
— Y 
—High 
—Wide 
— ^Angle 
— Curve 
Polarity 

Find By 


Image data source, a reference to an Image stnicture Pefault is $A$0. 
Fixture origin, defined by row, column, and angle offsets, typically to 
compensate for image-to-image variation in position, orientation, or 
both. Row and Column are oflsets, in pixels fiom the image origin. 
Theta is a rotafion fix)m the image row axis, ± 360'' CCW. Pefaults all 
0 (the image origin). See Working with Fixtures . 
Region of interest X and Y define the top-left point by offsets fiom the 
Fixture origin, in pixels. High and Wide are the height and width, in 
pixels. Angle is a rotation from the Fixture X axis, ± 360"* CCW. 
Curve is the angle between the sides of the region, ± 360° CCW). For 
curved regions, 'Vidth"is the arc distance at the center of the region. 
See Defining a Retnon ofJnteresL 

Expected grayscale transition, evaluated fix)m the inside to the outside. 
One of: either, black-to-white, or white-to-black. 
Criterion for selecting edges. One of: 
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• best score 

• first edge 

• last edge 


Emits 


Stores 
Comments 
Errors 
See Also 


Accept Thresh Acceptance threshold, a minimum score, 0 through 100. 
Angle Range Angular tolerance, ± 0 to 10 degrees. 
Edge Width Expected transition width, in pixels. 

Show Selects the graphics to display, as described in Flyover Graphics : 

• Hideall 

• Result graphics only 

• Input and result graphics 

• Show all, which di^lays ii^ut, result, and chart (if any) graphics. 

Number Found Number of edges found. Read by GetNPound . 
Start Row The row coordinate of PointO, the first point. Read by GetRow . 
Started The column coordinate of PointO, the first point. Read by GetCoL 

EndRow The row coordinate of Point 1 , the end point. Read by GetRow . 

EndCol The column coordinate of Pointl , the end point. Read by GetCol . 

Score The edge score, 0.00 to 100.00, a floating-point value. Read by 

GetScore . 

On success, an Edges stnicmre. which stores the edge results. 


Edges 

None. 
Invalid parameter. 
FindCircle. FindCurve. 


FindMultiLine. PairEdees, PairPistance. Pa irMax Distance. 


PairMeanPistance. PairMinPistance. PairSE>evDistance. FindSegment, SortEdges, 
TransEdgeTo World Geninff Started with E(he Detection . 


^ A ► Edge: FindMultiLine function 


Description 
Heading 
Syntax 
Inputs 


Finds multiple straight-line edges, returning an Edges stmcture. 
Vision Processing/Edge 

FindMultiLine(Image, Fixture, Region, Show) 

Image Image data source, a reference to an Image structure . Default is $A$0. 

Fixture Fixture origin, defined by row, column, and angle offsets, typically to 

— Row con^nsate for image-to-image variation in position, orientation, or 

— Column both. Row and Column are oflfeets, in pixels fiom the image origin. 
— ^Theta Theta is a rotation from the image row axis, ± 360^ CCW. Defaults all 

0 (the image origin). See Working with Fixtures , 
Region Region of interest. X and Y define the top-lefl point by offsets ftom the 

— X Fixture origin, in pbcels. High and Wide are the height and width, in 

— pixels. An^e is a rotation from the Fixture X axis, ± 360** CCW. 
— High Curve is the angle between the sides of the region, ± 360° CCW). For 
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Stores 
Emits 


Errors 
Comments 


See Also 


— wiae 
— Angle 
— Curve 
Number 
to Find 
Threshold: 
B2W 

Threshold: 
W2B 
Find By 


Angle Range 
Edge Width 
Show 


Edges 
index 
number 
found 
startRow 
startCoI 
endRow 
endCol 
score 


curvea reg ons, w qui s ine arc a stance ai me cenier oi tne reg on. 
See Defining a Region of Interest . 

Maximum number of edges to report. 

Minimum, black-to-white edge, 0 through 1 00. 

Minimum, white-to-black edge, 0 throu^ 100. 

Criterion for selecting edges. One of: 

• best score 

• first edge 

• last edge 

Angular tolerance, ± 0 to 10 degrees. 
Expected transition width, in pixels. 

Selects the graphics to display, as described in Flyover Gra phirK- 

• Hideall 

• Result graphics only 

• Input and result graphics 

• Show aU, which displays input, result, and chart (if any) graphics. 

On success, an Edges stmcnire, which stores the edge results. 
The edge number, 0.00 through n.OO. 
Number of edges found Read by GetNFound. 


The row coordinate of PointO, the first point Read by GetRow . 
The column coordinate of PointO, the first point Read by GetCol . 
The row coordinate of Point 1 , the end point Read by GetRow . 
The column coordinate of Point!, the end point Read by GetCol . 
The edge score, 0.00 to 100.00, a floating-point value. Read by 
GetScore . 
Invalid parameter. 

Extracts and stores points for as many edge intersection that fell within control limits up to 
the maxmium number expected. The output is always sorted by oflfeet fix)m the X-axis 
origin. 

FindCircle, FindCinve , RndLine, PairEdges. PairPistance, PairMaxDistance, 
PairMeanPistance, PairMinPistance. PairSPevDistance FindSegmenf, SortEdaes 
TransEdgeToWnrld ^ 


Insight) 


^ A ► Edge: FindSegment function 
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Description 

Heading 

Syntax 

Inputs 


Stores 
Emits 


Errors 
Comments 
See Also 


Finds an edge pair defined by a black or white segment. Returns an Edges structure. Emits 

the two edges. 

Vision Processing/Edge 

FindSegment(lmage, Fixture, Region, . . Show) 


Image 

Region 

—X 

— Y 

—High 

—Wide 

— ^Angle 

— Curve 

Segment 

Golor 

Find By 


Accept Thresh 
Angle Range 
Edge Width 
Show 


Edges 
Index 
Number 
Found 
StartRow 
StartCol 
EndRow 
EndCol 
Score 


Image data source, a reference to an Image stnicture . Default is $ A$0. 
Region of interest. X and Y define the topv-left point by offsets fix)m the 
Fixture origin, in pixels. High and Wide are the height and width, in 
pixels. Angle is a rotation fiDm the Fixture X axis, ± 360** CCW. 
Curve is the angle between the sides of the region, ± 360** CCW). For 
curved regions, '^vidth'Ms the arc distance at the center of the region. 
See Defining a Region of Interest , 

One of black or white. 

Criterion for selecting edges. One of: 

widest segment 
strongest edges 

Acceptance threshold, a minimum score, 0 through 100. 
Angular tolerance, ± 0 to 10 degrees. 
Expected transition width, in pixels. 

Selects the graphics to display, as described in Flyover Graphics : 

• Hide all 

• Resuh grq>hics only 

• Input and result gr^hics 

• Show all, which displays ii^ut, result, and chart (if any) graphics. 

On success, an Edges structure, which stores the edge results. 
The edge number, 0.00 through n.OO. 
Number of edges found. Read by GetNFound . 


The row coordinate of PointO, the first point. Read by GetRow . 
The column coordinate of PointO, the first point Read by GetCoL 
The row coordinate of Pointl, the end point. Read by GetRow . 
The column coordinate of Pointl , the end point Read by GetCol . 
The edge score, 0.00 to 100.00, a floating-point value. Read by 
GetScore . 

Invalid parameter. 
None 

FindCircle. FindCurv^e. FindLine. FindMultiLine. PairEdges. PairPistance. 
PairMaxDistance. PairMeanPistance^ PairMtnPistaiice . PairSPevPistance. SortEdges. 
TnmsEdgeTo World 
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^ A ► Edge: PairDistance function 


Description 
Heading 
Syntax 
Inputs 


Returns 

Emits 
Errors 
Comments 
See Also 


Returns the distance between a pair of edges. 

Vision Processing/Edge 

PairDistance(Edges, First Edge, Second Edge) 

Edges Input edges, a reference to Edges structurcv 

First Edge First edge in a pair. 

Second Second edge in a pair. 

Edge 

Distance between a pair of edges. In pixels unless the input Edges structure has been 

converted to other units by TransEdgeToWorid . 

Nothing. 

Invalid parameter. 
None. 

FindCircle, FindCitrve. FindLine. FindMiiltiLine. PairEdges. PairMaxDistance. 
PairMeaoDistance. PairMinPistance, PairSDevDi.stance, FindSeeinent. SortEdges. 
TransEdgeToWorid 


Insight) 


^ A ► Edge: PairEdges function 


Description 
Heading 
Syntax 
Inputs 


Groups multiple edge results into pairs, returning an Edges structure. 
Vision Processing/Edge 
PairEdges(Edges, Num of Pairs, . . Show) 


Stores 


Edges 
Num of 
Pairs 
First 
Edge 
Second 
Edge 
Edge Dist 
— Min 
— Max 
Intermediate 
Edges 

—Min B2W 
—Max B2W 
—Min W2B 
—Max W2B 
Edges 


Input edges, a reference to an Edges structure. 
Number of edges to compute. 

The polarity of the first edge. One of black-to- white, white-to-black, or 
either. 

The polarity of the second edge. One of black-to- white, white-to- 
black, or either. 

Minimum and maximum distances between two edges, in pixels. 


Maximum and minimum numbers of intemiediate wiiite-to-black and 
black-to-white edges. 


An Edges stmcture. which stores the edge results. 
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Emits 


Errors 
Comments 
See Also 


Index 
Number 
Found 
StartRow 
Started 
EndRow 
EndCol 
Score 


The edge pair number, 0.00 through n.OO. 
Number of edge pairs found. Read by GetN Found . 


The row coordinate of PointO, the first point Read by GetRow . 
The column coordinate of PointO, the first point Read by GetCol . 
The row coordinate of Point 1 , the end point. Read by GetRow . 
The column coordinate of Point 1, the end point. Read by GetCol . 
The edge score, 0.00 to 100.00, a floating-point value. Read by 
Get Score . 

Invalid parameter. 
None. 

FindCircle> FindCurye. FmdLine. FindMiiltiLine. PairDistance. PairMaxDistance. 
PairMeanPistance. PairMinPistance . PairSDevPistance. FindSecment. SortEdges. 
TransEdgeToWorld 


A ► Edge: PairMaxDistance function 

Description Returns the maximum distance between multiple edge pairs. 
Heading Vision Processing/TEdge 

Syntax PairMaxDistance(Edges) 

Inputs Edges Input edges, a reference to an Edges structure. 

Returns Minimum distance between points. In pixels unless the input Edges stmcture has been 

converted to other units by TransEdgeToWorld . 
Emits Nothing. 
Errors Invalid parameter. 

Comments None. 

See Also FindCirclc. FindCur\^e. FindLine. FindMultiLine. PairEdgcs, PairDistance. 

PairMeanPistance, PairMinPistance. PairSDevPistance. FindSegment SortEdges. 
TransEd geTo World 


^ A ► Edge: PairMeanDistance function 


Description Returns the mean distance between multiple edge pairs. 

Heading Vision Processing/Edge 

Syntax PairMeanDistance(Edges) 

Inputs Edges Input edges, a reference to Edges structure. 

Returns Mean (average) distance between edge pairs. In pixels unless the input Edges structure 

has been converted to other units by TratisEdgeToWorld . 

Emits Nothing 
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Invalid parameter. 
None. 

FindCircle, FindCurve, FindLine. FindMultiLine. PairEdges. PairPistance. 
PairMaxDistance, PairMinPistance. PairSDevDistance. FindSegiiient, SortEdges. 
TransEd geTo World 



^ A ► Edge: PairMinDistance function 


Description 

Returns the minimum distance multiple edge pairs. 

Heading 

Vision Processing^ge 

Syntax 

PairMinDistance(Edges) 

Inputs 

Edges Edge data. A reference to an Edees stmcture. 

Returns 

Minimum distance between points. In pixels unless the input Edges structure has been 


converted to other units bv TransEdeeTo World. 

Bnits 

Nothing. 

Errors 

Invalid parameter. 

Comments 

None. 

See Also 

FindCircle. FindCui-ve. FindLine. FindMultiLine. PairEdiies. PairDistance. 


PairjVlaxDistance. PairMeanDistance. PairSDevDistance. FindSecment. SortEdces. 


TransEdeeTo World 



Errors 
Comments 
See Also 


^ A ► Edge: PairSDevDistance function 


Description Returns the standard deviation of the distances between multiple edge pairs.. 
Heading Vision Processing/Edge 

Syntax PairSDevDistance(Edges) 

Inputs Edges Input edges, a reference to an Edges stmcture. 

Returns Standard deviation of distance between point In pixels unless the input Edges stmcture 

has been converted to other units by TransEdeeTo World . 
Emits Nothing. 
Errors Invalid parameter. 

Comments None. 

See Also FindCin:le, FindCurve. FindLine. FindMultiLine. PairEdges . PairPistance. 

PairMax Distance. PairMeanDistance. PairMinDistance . FindSeement SortEdges. 


TransEdeeToWorld 
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A ► Edge: SortEdges function 


Description 
Heading 
Syntax 
Inputs 


Stores 
Emits 


Drrors 
Comments 
See Also 


Sorts an Edges structure by specified criteria. Stores a new, sorted Edges structure. 
Vision Processing^Edge 

SortEdges(Edges, Number to Sort, Sort By, Show) 


Edges 
Num to 
Sort 
Sort By 


Input edges, a reference to an Edges structure. 
Number of edges to sort 

The criterion for sorting. One of: 

• best score 

• iirst to last 

• B2W by score, then W2B by score 

• B2W first-to-last, then W2B first-to-Iast 
Show or hide the graphic. 

On success, an Edges structure, which stores the edge results. 
The edge number, 0.00 through n.OO. 
Number of edges found. Read by GetNFoimd . 


Show 
Edges 
Index 
Number 
Found 
StartRow 
Started 
EndRow 
EndCol 
Score 

Invalid parameter. 
None. 

FindCircle, FindCiirv^e. FindLine. FindMultiLine. PairEdges. PairDistance. 
PairMaxDistancc. PairMeanPista nee , PairM inPistance, PairSDevDistance. FindSegment. 
TransEdgeToWorld 


The row coordinate of PointO, the first point Read by GetRow . 

The column coordinate of PointO, the first point Read by GetCol . 

The row coordinate of Point 1 , the end point Read by GetRow . 

The column coordinate of Point 1 , the end point. Read by GetCol . 

The edge score, 0.00 to 100.00, a floating-point value. Read by GetScore. 
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^ A ► Geometry: Overview 


The Geometry functions construct geometric shapes (under Fit) and gauge distances and angles (under 
Measure). Using them, you can find the distances, intersections, and angles of points, lines, and circles in 
vanous combinations. These geometric measurements are a cnicial part of many inspection applications, 
u^ch use them to confirm the dimensions and location of a part 

This section introduces the Geometry fimctions, discussing the following topics: 

• Getting Started with Measurement 

• Geometry Function Reference . 

V 

Most of flie measurement fimctions return a Dist stnicture, which stores a line segment described by its end 
pomts, distance (its length), and an angle (fiom the image row axis, by default). They also emit fomiulas to 
place the cunent Dist values in a block of cells. If your application does not use one of the emitted fomiulas 
you can remove it fi*om the woricsheet. 

NOTE The measurement fimctions are independent fix>m the unit of measure. They p«fonn an appropriate 
computation on their floating-point inputs but don't "know*' what the inputs represent If the inputs 
are m Image units (rows and columns, in pixels), thai the ou^uts are in Image units. But if the inputs 
are m World units (translated ftom the image through Calibrated , then the outputs are in World units 


^ A ► Geometry: Getting Started 


In this topic, you measure the distance between two points with the PointToPoint fimction. The result looks 
like this: 
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Completing this exercise gives you hands-on experience with geometric measurement The steps listed here 
generalize to the other measurement functions. 

► To Measure the Distance between Two Points 


1 . Acquire an appropriate image. For this exercise: 

a. Open the part sample image, print it, and return to this topic. Place the printed image under the 
camera. 

b. Click and release A, select Live from the System menu, and click X to enter live mode. 
Interactively adjust the image location, camera height, aperture, and focus until satisfied with the 
image. 

c. Click A twice to exit live mode, acquire the last image, and return to the worksheet 

To acquire a new image at any time, hold □ and click X. 

2- Before you can measure a point-to-point distance, you need two points. For this exercise. 
Ex tracts lobs is a convenient source of point data: 

a. Leaving cell Al empty, move to cell A2 and click Xto open the Formula Builder. 

NOTE Try to leave a blank row above functions that emit formulas. Li-Sight prints descriptive 
labels above emitted formulas if it has room for the labels. If the row above is 
occupied, it emits only the numoic values, without labels. 
From Vision Processing, open the Blob heading, and then open the ExtractBlobsQ property 
sheet. 

To define the region of interest, click the Region heading. In-Sight hides the worksheet and 
displays the Region cursor . Using the Control Pad, surround the part image, which has at most 
six blobs (four small round holes, one larger rectangular hole, and the entire perimeter). Click X 
to return to the property sheet 

increase the Number to Find value to 2 and click X to accept it. (This value detemiines the 
number of blobs to extract. Each blob has a centroid point, and the two centroids define a 
distance to be measured.) 

Decrease the Area Limit: Max value to 1000 (to exclude the perimeter and the rectangular 
hole as blobs), click X to accept, and click OK to close the property sheet. ExtractBlobsQ 
extracts two blobs, stores Aem in a Blobs structure, and emits various formulas: 


b. 


e. 



Region 


The values of interest here are the centroid Row and Column values. You can ignore or remove 
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the other emitted values. 
3. Measure the distance between the points: 

a. From cell A5, click Xto open the Fomiula Builder. From Geometry, open the Measure 
heading, select the PointToPointQ function, and click X to open its property sheet 
Select the Point 0 parameter, click X to enter interactive reference mode, move to cell C2 
hold the O button, and select the range C2:D2 (the row and column centroid for the fiist blob 
mdexed 0). 

Release O, and then click X to accept the reference, returning to the property sheet 
Select the Point 1 parameter, dick >; move to cell C3, hold O, select C3:D3 (the row and 
column centroid for the second blob), and click X to accept. 

Click OK to close the property sheet. PointToPointQ returns a Dist structure to store its 
results. It also emits the end points of a line segment, its length, and its angle fix)m the image 
row axis: * 


b. 


c. 
d. 


BlobO 


Blob 1 



The value m F5 is measured distance between the two points. In this case, the input row and 
column values are m image coordinates. They are pixel offsets from the image origin. Therefore 
the measured distance is the number of pixels between the two points. Converting the Blobs 
structure to World coordinates through TransBlohToWnrhl would transform the centroid row 
and column values to World coordinates. The results from PointToPointQ, reflecting its inputs 
would also be in World units. ' 

By defeult, In-Sight displays the graphics associated with the Dist structure only when you highlidit it, as 
Stow^ ""^^^^^^^^^^^^ "^"^^^^ ^^^"^ ^" the time, set the fimction's Show parameter to 

The procedures for using the other measurement functions are similar to those listed here. 


^ A ► Geometry: Function Reference 
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CircleFroniPoints Constructs a circle from three points. Returns a Circle structure. Emits the center row, 
center column, and radius. 

CircleToCircle Measures the shortest distance between two circles. Returns a Dist structure. Emits the 
segment's end points, distance, and angle. Distance is positive if the circles are 
separated, 0.0 if tangent or intersecting, negative if enclosed. 

Dist structure Stores a line segment defined by its end points, length, and an angle (from the image 

row. axis, by default). 

LineToCircle Measures the shortest distance from a line to a circle. Returns a Dist structure. Emits 

the segment's end points, distance, and angle. If the line and circle intersect, emits the 

point(s) of intersection, and the distance is 0.00. 
LineToLine Measures the angle between two lines, in CCW degrees. Returns a Dist structure. 

Emits the intersection point, distance, and angle, fritersecting: distance is 0.00. Parallel: 

distance is positive, and the angle is 0, +1 80, or -1 80. 
MidLineToMidLine Measures the shortest distance between the midpoints of two line segmaits. Returns a 

Dist structure. Emits the segment's end points (the midpoints), distance, and angle. 
PointToCircle Measures the shortest distance fix)m a point to a circle. Returns a Dist structure. Emits 

the segment's end points, distance, and angle. Distance is positive if the point is outside 

the circle, 0.0 if on it, negative if inside. 
PointToLine Measures the shortest distance from point to a line. Returns a Dist structure. Emits the 

segment's end points, distance, and angle. 
PointToPoint Measures the shortest distance between two points. Returns a EHst structure. Emits the 

segment's end points, distance, and angle. 
PointToPointAnt;le Returns the angle of a line segment with respect to the image row axis, in 

coimterclockwise degrees. 
PointToPointDistance Retums the distance between two points. 

SegmentFromLines Constructs a line segment by averaging two line segments. Returns a Line structure. 
Emits the end points. 

Data Access functions that get values from a Dist structure are GetAngle. GetCoK GctDistance. GetRow . 


^ A ► Geometry: CircleFromPoints function 


Description Constructs a circle from three points. Returns a Circle structure. Emits the center row, 

center column, and radius. 
Heading Geometry/Fit 

Syntax CircleFromPoints(Point 0, Point I , Point 2, Show) 
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Inputs 


Point 0 
— Row 
— Column 
Point 1 
— Row 
— Column 
Point 2 
— Row 
^-Ccrfumn 
Show 


Stores 
Emits 


Circle 
Row 

Column 

Radius 


En-ors 
Comments 
See Also 


First point, row and column coordinates. 
Second point, row and column coordinates. 
Third point, row and column cooidinates. 

Selects the graphics to display, as described in Flyover Gra phirx- 

• HideaU 

• Result graphics only 

• Input and result graphics 

• Show aU, which di^lays input, result, and chart (if any) graphics. 
On success, a Circle structure . 

Center row, in the same coordinate system as the input points. Read bv 
GetRow . ^ 

Center column, in the same coordinate systan as the ii^ut points. Read by 
GetCol . 

The radius, in the same coordinate system as the input points. Read by 
GetRadius . 


Invalid point, or the points are collinear and therefore do not define a circle 
None. 

SegmentFromLines . 


Insight* 


^ A ► Geometry: CircleToCircle function 

Description Measures the shortest distance between two circles. Returns a Dist structure. Emits the 
s^n^t^s end points, distance, and angle. Distance is positive if the circles are separated, 
0.0 if tangent or intersecting, negative if enclosed 
Heading Geometry/Measure 
Syntax CircleToCircle(Circle 0, Circle 1 , Show) 

Inputs Circle 0 First circle: center point and radius. 

— ^Row 
— Column 
— Radius 
Circle 1 
— ^Row 
— Column 
— Radius 
Show 


Second circle: center point and radius. 


Selects the graphics to display, as described in Flyover Gra phir.^- 
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• HideaU 

• Result graphics only 

• Input and result graphics 

• Show all, which displays input, result, and chart (if any) graphics. 
Stores Dist On success, a Dist structure . 

Emits RowO First end point or intersection, in the same coordinate system as the input 

points. Read by GetRovv . 
ColO First end point or intersection, in the same coordinate system as the input 

points. Read by GetCoi . 
Rowl Second end point or intersection, in the same coordinate system as the 

input points. Read by GetRow . 
Coll Second end point or intersection, in the same coordinate system as the 

input points. Read by GetCol . 
Distance Length of the line segment, in the same coordinate system as the input 

points. Positive values indicate the circles are separated; 0.00 indicates 

tangent or intersecting circles; negative indicate that one circle encloses the 

other. Read by GetDistance. 
Angle Angle of the line segment Measured from the image row axis unless the 

input points are in World coordinates. Read by GetAnde . 
Errors Invalid parameter. 

Comments Cases are: 

Points are end points. Distance is positive. 

Points are single point of intersection and identical. 
Distance is 0.0. 



Points are intersections. Distance is 0.0. 
Points are end points. Distance is negative. 


Points are intersection and identical. Distance is Oil. 


See Also LineToCircle. PointToCirele. PointToLine 



^ A ► Geometry: Dist structure 


■ OO 
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Description 
Values 


Comments 
See Also 


Stores a line segment defined by its end points, length, and an angle (fix)m the image row 
axis, by default). 


Value 
RowO 


Description 

The first end point In pixels &om the image origin 
unless the input points are in World coonlinates. 
The first end point In pixels from the image origin 
unless the input points are in World coordinates. 
The second end point In pixels from the image 
origin unless the input points are in World 
coordinates. 

The second end point In pixels fix>m tfie image 
origin unless the input points are in World 
coordinates. 

The measured distance between the two end 
points. In pixels unless the input points are in 
World coordinates. 

Angle value, in counterclockwise degrees. 
Measured fiDm the image row axis unless the ir^ut 
points are in World coordinates. 

None. 

CircleToCircle, LineToCin:!e. LineToLine. Midl^ineToMidLine. PointToCin^le 
PointToLine, PobtToPoint 


ColO 


Rowl 


Coll 


Distance 


Angle 


Access function 
GetRow. index 0 

GetCol. index 0 

GetRow. index 1 


GelCol. index 1 


GetDistance 


GetAngle 


^ A ► Geometry: LineToCircle function 


Description 


Heading 

Syntax 

Inputs 


Measures the shortest distance from a line to a circle. Returns a Dist structure. Emits the 
segment's end points, distance, and angle. If the line and circle intersect, emits tfie point(s) 
of intersection, and the distance is 0.00. 
Geometry/Measure 
LineToCircle(Line, Circle, Show) 

line A line. Row 0 and Column 0 are the first end point, and Row 1 and 

— RowO Column 1 are the second end point In Pixel or World units. 
— CohunnO 
— Rowl 
— Cohunnl 

Circle A circle, defined by its center point and radius. In Pixel or World units 

— Row 
— Column 
— Radius 

Show Selects the graphics to display, as described in Flyover Graphics : 


Hide all 
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Stores 
Emits 


Errors 
Comments 


See Also 


• Result gr^hics only 

• Input and result graphics 

• Show all, which displays iiq>ut, result, and chart (if any) graphics. 
Dist On success, a Dist structure . 

RowO First end point or intersection, in the same coordinate system as the input 

points. Read by GetRow . 
CoIO Firet end point or intersection, in the same coordinate system as the input 

points. Read by GetCol . 
Rowl Second end point or intersection, in the same coordinate system as the 

input pK)ints. Read by GetRow . 
Coll Second end point or intersection, in the same coordinate system as the 

input points. Read by GetCol . 
Distance Length of the line segment, in the same coordinate system as the input 

points. 0.00 indicates intersection. Read by GetOi stance . 
Angle Angle of the line segment. Measured from the image row axis unless the 

input points are in World coordinates. Read by GetAngle . 
Invalid parameter. 

LineToCircleO treats the segment defined by (RowO, ColumnO) and (Rowl, Columnl) as 
a line, projecting it if necessary to obtain its result points: 


Specified segment 
Projection 



(Row 0, Col o> 
(Row 1, Col 1> 


Result point 


.'^^ Result point 

If the line and circle intersect, the returned distance is zero. The cases are: 

^ C^^^^^)^ Points are end points. Distance is positive. 

B C3-^ Points are tangent and identical. Distance is 0.0. 

C C^^^^^ Points are intersections. Distance is 0.0. 

CircleToCiicle. LineToLina MidLineToMidLine. PointToCircle . PointToLine 


^ A ► Geometry: LineToLine function 


SDCXrD: <WO_0111445A2_t_> 


Appendix I - Page 181 


wo 01/11445 PCTAJSOO/22383 


I>escription 


Heading 

Syntax 

Inputs 


Stores 
Emits 


Measures the angle between two lines, in counterclockwise degrees. Returns a Dist 
structure. Emits the intersection point, distance, and angle. Intersecting: distance is 0.00. 
Parallel: distance is positive, and the angle is 0, +1 80, or -1 80. 
Geometry/Measure 
LineToLine(Line 0, Line 1, Show) 

Line 0 A line. Row 0 and Column 0 are the first end point, and Row 1 and 

Column 1 are the second end point. Li Pixel or World units. 


— RowO 
— CohunnO 
— Rowl 
— Columnl 
Line 1 
— RowO 
— ColumnO 
— Rowl 
— Cohunnl 
Show 


A line. Row 0 and Column 0 are the first end point, and Row 1 and 
Column 1 are the second end point. In Pixel or World units. 


Selects the graphics to display, as described in Flyover Graahics : 

• Hideall 

• Result graphics only 

• Lput and result graphics 

• Show all, which displays input, result, and chart (if any) graphics. 


Dist 


On success, a Dist structure . 
NOTE When the lines intersect, this function emits the same point twice, so RowO = 
Rowl and ColO = Coll. 
First end point or intersection, in the same coordinate system as the input 
points. Read by GetRow . 

First end point or intersection, in the same coordinate system as the input 
points. Read bv GetCoL 

Second end point or intersection, in the same coordinate system as the input 
points. Read by GetRow . 

Second end point or intersection, in the same coordinate system as the input 
points. Read by GetCol . 
Distance Length of the line segment, in the same coordinate system as the mpax points: 

• Zero if the lines intersect. 

• A positive value if the lines are parallel, indicating their measured 
separation. 


RowO 
Colo 
Rowl 
Coll 


Read by GetDistance . 
Angle Angle of the line segment: 


• The measured angle, -180 to +1 80 degrees, if the lines intersect. 
. One of 0.00, +1 80.00, or -180.00 if the hnes are parallel. The direction 
of the lines determines the angle value returned: 


line 0 


Kne 0 
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0 degrees 
line 1 ^ 


■g -1»U aegrees 
^7 Hne 1 


'SS -t^ltfU degrees 
^7 line 1 


Errors 
Comments 


See Also 


c 

B tine 0 

e 

J linel 



-*■ angle 


linel 


ItneQ 



angle 


Measured from the image row axis unless the input points are in World 
coordinates. Read by GetAngle . 
Invalid parameter. 

LineToLineO treats both segments defined their (Row 0, Column 0) and (Row 1 , Column 
1) end points as lines, projecting them if necessary to obtain the intersection point. Cases 
are: 

A ^^>*<C^ Points are intersection and identical. Distance Is 0,0. 

Angle is 0.0, indicating parallelism. 
Distance is positive, indicating separation. 
Points are endpoints of distance. 


LineToCircle. MidLineToMidLine> PointToPoint Angle 


^ A ► Geometry: MidLineToMidLine function 


Description 

Heading 

Syntax 

Inputs 


Measures the shortest distance between the midpoints of two line segments. Returns a 
Dist structure. Emits the segment's end points (the mid^ints), distance, and angle, 
Geometry/Measure 

MidLineToMidLine(Line 0, Line 1, Show) 


LineO 
— RovK) 
— ColumnO 
— Rowl 
— Columnl 
Line 1 
— RowO 
— ColumnO 
— Rowl 
— Coliunnl 
Show 


A line. Row 0 and Column 0 are the first end point, and Row 1 and 
Column 1 are the second end point. In Pixel or World units. 


A line. Row 0 and Column 0 are the first end point, and Row 1 and 
Column 1 are the second end point. In Pixel or World units. 


Selects the graphics to display, as described in Flyover Graphics : 

• Hideall 

• Result graphics only 

• Input and result graphics 

• Show all, which displays input, result, and chart (if any) graphics. 
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Stores 
Emits 


Errors 
Comments 


Dist 
Ro>vO 

ColO 

Rowl 

Coll 

Distance 

Angle 


On success, a Dist structure . 

First midpoint, in the same coordinate system as the input points. Read by 
GetRow . 

First midpoint, in the same coordinate system as the input points. Read by 
GetCol - 

Second midpoint, in the same coordinate system as the input points. Read 
by GetRow . 

Second midpoint, in the same coordinate system as the input points. Read 
bv GetCoL 


Length of the line segment, in the same coordinate system as tiie input 
points. Read by GetPistance . 

Angle of the line segment Measured fiom the image row axis unless the 
input points are in World coordinates. Read by GetAnale . 
hivalid parameter. 
Cases are: 


I 


See Also 


Points are midpoints. Distance is positive. 

B XLl Points are midpoints. Distance is positive. 

LineToCircle. LineToLine. PointToLine 



^ A ► Geometry: PointToCircle function 


Description 


Heading 

Syntax 

hiputs 


Measures the shortest distance from a point to a circle. Retums a Dist stmcture. Emits the 

segment's end points, distance, and angle. Distance is positive if the point is outside the 

circle, 0.0 if on it, negative if inside. 

Geometry/Measure 

PointToCircIe(Point, Circle, Show) 

Point A point hi Pixel or World units. 

— Row 


— Column 
Circle 
— Row 
— Column 
— Radius 
Show 


A circle, defined by its cento- fx>int and radius. In Pixel or World units 


Selects the graphics to display, as described in Flyover Graphics - 

• HideaU 

• Result graphics only 

• Irq)ut and resuh gr^hics 

• Show all, which displays input, result, and chart (if any) graphics. 
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Stores 
Emits 


Errors 
Comments 


Dist On success, a Dist structure , 

RowO First end point or intersection, in the same coordinate system as the input 

points. Read by GetRow . 
ColO First end point or intersection, in the same coordinate system as the input 

F>oints. Read by GetCol . 
Rowl Second end point or intersection, in the same coordinate system as the 

input points. Read by Get Row . 
Coll Second end poinii or intersection, in the same coordinate system as the 

input points. Read by GetCol . 
Distance Length of the line segment, in the same coordinate system as the input 

points. A positive value if the point is outside the circle, 0.0 if on the circle, 

negative if inside the circle. Read by GetDistance . 
Angle Angle of the line segment. Measured from the image row axis unless the 

input points are in World coordinates. Read by GetAngle . 
Invalid parameter. 

If the point and circle intersect, the measured distance is zero, and the end points are 
identical. Case are: 


o 
o 

G 


Points are end points. Distance is positive. 


Points are identical. Distance is 0.0. 


See Also 


C ( *—} Points are end points. Distance is negative. 

CircleToCtrcle. LineToCircle. PointToLinc 


A ► Geometry: FointToLine function 

Description Measures the shortest distance from point to a line. Returns a Dist structure. Emits the 

segment's end points, distance, and angle. 
Heading Geometry/Measure 
Syntax PointToLine(Point, Line, Show) 

Inputs Point A point. In Pixel or World units. 

—Row 

— Column 

Line A line. Row 0 and Column 0 are the first end point, and Row 1 and 

— ^RowO Column 1 are the second end point. In Pixel or World units. 
— CoiumnO 
— Rowl 
— Column 1 

Show Selects the graphics to display, as described in Flyover Graphics : 
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Stores 
Emits 


Errors 
Comments 


Dist 
RowO 


ColO 


Rowl 


Coll 


Distance 


Angle 


Hide all 

Result graphics only 
Input and result gr^hics 

Show all, which displays input, result, and chart (if any) graphics. 


On success, a Dist structure . 

First end point or intersection, in the same coordinate system as the input 
points. Read by GetRow . 

First end point or intersection, in the same coordinate system as the input 
points. Read by GetCo! . 

Second end point or intersection, in the same coordinate system as the 
input points. Read by GetRow . 

Second end point or intersection, in the same coordinate system as the 
input points. Read by GetCol . 

Length of the line segment, in the same coordinate system as the input 
points. Zero if the point falls on the line. Read by GetPistance . 
Angle of the line segment Measured from the image row axis unless the 
input points are in WorJd coordinates. Zero if the point falls on the hne. 
Read by GetAngle . 
Invalid parameter. 

PointToLineO treats the segments defined (Row 0, Column 0) and (Row 1 , Column 1 ) as 
a line, projecting it if necessary to obtain the intersection point. 

If the point falls on the line, the distance and angle are both zero. Cases are: 

No projection. Result points are endpoints. 
Distance is positive. 

Segment projected. Result points are endpoints. 
Distance is positive. 

Point falls on the projected line. 
Distance is 0.0. 


See Also LineToCiicle. LineToLine. MidLineToMidLine. PointToCircle 


^ A ► Geometry: PointToPoint function 

Description Measures the shortest distance t>etween two points. Returns a Dist structure. Emits the 

segment's end points, distance, and angle. 
Heading Geometry/Measure 
Syntax PointToPoint(Point 0, Point 1 ) 
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Inputs 


A point In Pixel or Worid units. 


Returns 
Emits 


Errors 
Comments 

See Also 


A point. In Pixel or World units. 


Point 0 
— Row 
— Column 
Point 1 
— Row 
— Column 

Dist On success, a Dist structure . 

RowO First end point or intersection, m the same coordinate system as the inpiu 

points. Read by GetRow . 
CoIO First end point or intersection, in the same coordinate system as the input 

points. Read by GetCol . 
Rowl Second end point or intersection, in the same coordinate system as the 

input points. Read by GetRow . 
Coll Second end point or intersection, in the same coordinate system as the 

input points. Read by GetCol . 
Distance Length of the line segment, in the same coordinate system as the input 

points. Zero if Point 0 = Point 1. Read by GetDistancc . 
Angle Angle of the line segment. Measured from the image row axis unless the 

input points are in World coordinates. Zero if Point 0 = Point 1 . Read by 

GetAnglc . 
Invalid parameter. 

Differs from PointToPointAngle and PointToPointDistance by returning a Dist structure 
instead of a floating-point value. 

LineToLine. MidLineToMidLine. PointToLine. PointToPointAngle. 
PointToPointDistance, Getting Started with Geometric Measurement . 


InfSlght) 


A ► Geometry: PointToPointAngle function 


Description 
Heading 
Syntax 
Inputs 


Returns 


Emits 
Errois 
Comments 


Returns the angle of a line segment, in counterclockwise degrees, as a floating-point value. 

Geometry/Measure 

PointToPointAngle(Point 0, Point 1) 

Point 0 A point. In Pixel or World units. 

— Row 

— Column 

Point 1 A point. In Pixel or World units. 
— Row 
— Column 

Angle of the line segment, in counterclockwise degrees, as a floating-point value. 
Measured from the image row axis unless the iiput jwints are in World coordinates. Zero 
ifPointO = Point 1. 
Nothing: 

Invalid parameter. 

Differs from PouitToPoint by returning a floating-point angle instead of a Dist structure. 
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See Also 


LiiieToLiiie. MidLineToMidLine. PointToLine. PointToPoint . 


^ A ► Geometry: PointToPointDistance 
function 


Description 
Heading 
Syntax 
Inputs 


Returns 

Emits 
Enors 
Comments 
See Also 


Returns the distance between two points. 
Geometry/Measure 

PointToPointDistance(Point 0, Point 1) 
Point 0 A point. In Pixel or World units. 
— ^Row 
— Column 

Point 1 A point. In Pixel or World units. 

— Row 
— Column 

Length of the line segment, in the same coordinate system as the input points. A floating- 
point value. Zero if Point 0 = Point 1 . 
Nothing. 

Invalid parameter. 

Differs from PointToPoint by returning a floating-point angle instead of a Dist structure. 
CircleToCircle, LineToCircle. LineToLine. MidLineToMidLine. PointToCircle. 
PointToLine. PointToPoint PointToPointAnf zle. 


In^lght^ 


^ A ► Geometry: SegmentFromLines function 


Description 

Heading 

Syntax 

Inputs 


Constructs a line segment by averaging two line segments. Returns a Line stnicture. Emits 

the end points. 

Geometry/Fit 

SegmentFromLines(Line 0, Line 1, Show) 


Line 0 
— RowO 
— ColumnO 
— Rowl 
— Column! 
Line 1 
— RowO 
— ColumnO 
— Rowl 
— Columnl 
Show 


A line. RowO and ColumnO are the first end point, and Rowl and 
Columnl are the second end point. In Pixel or World units. 


A line. RowO and ColunuiO are the first end point, and Rowl and 
Columnl are the second end point. In Pixel or World units. 


Selects the eraohics to disolav. as described in Fivover Graohics: 
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• HideaU 

• Result gr^hics only 

• Input and result graphics 

• Show all, which displays input, result, and chart (if any) graphics. 
Stores line On success, a Line structure . 

Eniils RowO First end point, row or X coordinate, in the same coordinate system as the 

input points. Read by GetRow . 
ColO First eiKi point, column or Y coordinate, in the same coordinate system as 

the input points. Read by GetCol 
Rowl Second end point, row or X coordinate, in the same coordinate system as 

the input points. Read by GetRow . 
Coll Second end point, column or Y coordinate, in the same coordinate system 

as the input points. Read by GetCol . 
Errors Invalid paiBmeter. 

Comments None. 
See Also CircieFromPoints. 
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^ A ► Graphics: Overview 

The Graphics functions draw graphics on the image or in worksheet cells. They are grouped three headings 
Controls, Displays, and Iniage. The controls— buttons, list boxes, check boxes and so on— are graphical 
inputs stored in worksheet cells, commonly as part of an operator interface. Controls remain editable even 
when the worksheet is locked, so that the operator can control the application. The displays are output 
graphics drawn in a worksheet cell, to monitor a value for application development or deployment Displays 
include charls that plot the history of a value (to determine cocr^ parameter settings, or for process 
monitoring) and a status indicator (color coded for Pass/FailA^/aming). The Image functions draw overlay 
graphics— arcs, circles, crosses, and so on — on the image. 

This section introduces the Graphics functions, discussing the following topics: 

• Getting Started with Image Graphics 

• Getting Started with Worksheet Graphics 

• Getting Started with Charts 

• Graphics Function Reference . 

The graphics are drawn on the image by a nondestmctive overlay. They influence the displayed image but 
not the underlying pixel data. Attributes available for aU image graphics are a name (a label), a color, and a 
toggle to enable or disable the graphic. 


^ A ► Graphics: Using Image Graphics 

In this topic, you draw a circle over an image, yielding this result: 









n 

: Circle 

|:oi 












i— Name 


iseiot^: 

^^^^^^ 












i : 4i:^ 






i 


The steps for drawing other shapes such as arcs, points, and lines are similar to those described here. 

► To Draw a Orcle 

I . You define a circle witii three values, its center row, center column, and radius. For this exercise, you 
place static values in three cells and subsequently refer to them to define the circle: 

a. From cell Al, click and hold >< select Value firom the Enter menu, edit the value 100.0 into 
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the cell, and click X to accept it. This value will be the center row coordinate. 

b. From cell Bl , repeat the process to put 300.0 into B 1 , to serve as the center column 
coordinate. 

c. From cell CI, repeat the process to put 25.0 into CI. This value will be the radius, in pixels. 
Any of these values can be static, computed by formulas, or stored in a Circle stnictiire. 

From cell A2, click Xto open the Formula Builder . 

From the Graphics category, select Image, and then op6n the PlotCircle property sheet. 
Connect PlotCircleQ to the row, column, and radius values by creating relative references : 

a. Select the Circle heading, and then click and hold X, opening the Enter menu. 

b. Select Relative and release >^ placing In-Sight in interactive reference mode. 

c. Move the marquee to cell Al, hold down the O button, and click cursor Right to select the 
range A1:C1. Release O, and then Xto select the references, returning to the property sheet. 


You could, alternatively, create absolute references. 


5. From the Name heading, click opening the Text Entry dialog . 

6. Edit the string "My Circle", then click OK to accq>t the name, returning to the property sheet. 

7. From the Color heading, select Dark Red, and clickX to accept it, returning to the property sheet. 

8. Click OK, accepting the parameteis and closing the property sheet In-Sight draws the specified 
circle: 









:i 







: 1^ Circle 

•i .1. 






-L- Name 

F2J- 






1 







1 

i 







i3 


With cell A2 highli^ted, In-Sight draws the circle as a flyover graphic . It therefore has the default 
color, not the specified color (Dark Red). To view the circle exactly as defined, move away fham A2. 


^ A ► Graphics: Using Worksheet Graphics 

In this topic, you put a button in the worksheet that acquires a new image when clicked: 


: Air ;i BiJtton("C6ck T6>Acquire'') v; f . ■ 




c ^ r- 








^taciick To -Acquire 
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The steps for defining other worksheet graphics are similar to those described here. 
► To Put a Button in a Cell 

1 . From cell Al, click Xto open the Formula Builder. 

2. From the Graphics category, select Worksheet, and then open the Button property sheet. 

3 . On the String parameter, click X opening the Text Entry dialog. 

4. Edit the string "Click to Acquire". 

5. Click OK to accept the name, closing the property sheet and placing a Q graphic in Al. 
NOTE In-Sight dig)lays as much of the button lai>el as it can without hiding an occi5)ied cell. If tfie 

label is too long to fit in one cell and the adjacent cells are unoccupied, In-Sight displays the 
entire label. If the adjacent cells are occupied, it truncates the label at the first occupied cell. 
Move to cell AO, which contains an Image structure that stores the acquired image. 
Click X to open the AcQuireTmage property sheet. 

On the ??Intemal Trigger?? parameter, click X to switch to interactive reference mode. 
Move the marquee to Al, and then chck X to accept die reference. Click OK to close the property 
sheet. 

Move to Al. 

Click X on the a graphic. In-Sight acquires a new image. 

IntmiaUy, ceD Al's value changes fi^om 0.00 to 1 .00 when clicked In-Sight passes the change to 
AcquirelmageO, which responds by acquiring a new image. To view the change in value: 

a. Move to cell A2. 

b. Click and hold X, select Relative fi-om the Enter menu, and release X 

c. Move the marquee to Al, the ButtonQ cell, and click X to accept the reference. Bl displays 
0.00, the current (unclicked) value of ButtonQ. 

d. Move to Al and click the button. Bl displays 1 .00, the value when clicked. 



^ A ► Graphics: Using Charts 

In this topic, you create a chart, a graphic that records a changing value over time. The result looks like this: 
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During setup, you can use charts to help detennine correct parameter settings. In the depJoyed application, 
you can use charts to improve process monitoring. 

► To Create a Chart 

1 . Acquire an appropriate image. For this exercise: 

a. Open the part sample image, print it, and return to this topic. Place the printed image under the 
camera. 

b. Click and release A, select Live fix)m the Syst^n menu, and click X to enter live mode. 
Interactively adjust the image location, camera height, aperture, and focus until satisfied with the 
image. 

c. Click ^ twice to exit live mode, acquire the last image, and return to the worksheet. 
To acquire a new image, hold □ and click X. 

2. Before you chart a value, you have to have a value to chart. A convenient value for this exercise is the 
contrast result fiom a histogram. To obtain it: 

a. From cell A2, click Xto open the Fomiula Builder . 

b. From Vision Processing, open the Histogram heading, and then open the ExtractHistogram 
property sheet. 

c. Click X on the Region heading, switching to the interactive Region cursor. Use the Control Pad 
to adjust the region so that it includes a feature in the image. 

d. Click X to accept the region, and then click OK to close the property sheet. In-Sight computes 
the histogram and emits the contrast and other values. 

3. From cell A3, click Xto open the Formula Builder. From Graphics, open the Worksheet heading, 
and then open the Chart property sheet. 

4. Select the Value parameter and click switching to interactive reference mode. 

5. Move the marquee to cell G2, the contrast value. CHck X to accept the reference and return to the 
property sheet. 

6. Select the Chart Name parameter and click X hi the resulting Text Entry dialog, edit the name "My 
Chart" and click X to accept. 

7. Leave the Range Min and Range Max values unchanged When both are 0.00 (the default), 
ChartQ automatically determines the range based on recent values. A large increase or decrease in the 
charted value might change the automatic ranges. Setting either Range Min or Range Max to a 
non-0.00 value overrides the automatic range in favor of the requested range. 

8. Click OK to close the property sheet. In-Si^t replaces the worksheet row containing ChartQ with a 
chart graphic. At this point, the chart contains only one value, the current histogram contrast. 
NOTE If the row containing the chart already contains a value, then the chart graphic hides the value. 

The chart does not destroy any data, but you can't see other values in the row because the 
chart is in the way. You can move from cell to cell in the hidden row, keeping track of the 
column through the highlight in the column header. References to the hidden cell remain intact 

This situation creates a risk of confusion. For exanq>le, if you clear the Chart() cell and 
accidentally select one or more hidden cells that contain values, then you lose the data in the 
hidden cells. ConsidCT adopting the habit of creating charts in empty rows. 

9. Chck and release A to open the System menu. Select Triggers to open the Triggers menu, and then 
click Manual. In-Sight acquires a new image and updates the chart, w^ch now contains two values. 
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10. 


11. 


Small differences in lighting usually cause the histogram contrast value to change slightly fiom image to 
image. The chart reflects these differences. 

CUck Manual at least ten more times to fill the chart with vahies. (You can set the number of time 
increments to plot in the Chart property sheet The default, unchanged here, is 10.) After the chart 
fills, the oldest value rolls off the left end 

From tfie Triggers menu, enable Continuous. In-Sight acquires images as quickly as possible, 
i:qxiating the chart to reflect them. 


A ► Graphics: Function Reference 


Burton 

Chart 
Check Box 


ColorLabel 

Dialog 

EdilFloat 

Editint 

EditString 

ListBox 

Plot sti-ucture 
PlotArc 

PlotCircle 

PlotCross 

PbtLine 

PiotPoint 

PlotRegion 

PlotStrin^ 

Status 


Puts a labeled button control, Q, in a cell. Returns 1.00 when clicked, 0.00 otherwise. 

Remains adjustable when the worksheet is locked. 

Puts a chart display in a cell, to plot the history of a value. 

Puts a labeled check box control in a cell. When ON pi), returns 1 .00; when OFF (□), 
0.00. Typically referenced to set a toggled value. Remains adjustable when the worksheet 
is locked. 

Puts a text string of a specified color in a cell of a specified color. 
Creates a view window opened by a labeled button. 

Puts a numeric edit box control in a cell. Returns a floating-point value constrained to a 
specified range. Remains adjustable when the woiksheet is locked. 
Puts a numeric edit box control in a cell. Returns an integer constrained to a specified 
range. Remains adjustable when the woiksheet is locked. 

Puts a text edit box control in a cell. Returns a string limited to a specified maximum 

number of characters. Remains adjustable when the worksheet is locked 

Puts a list box control in a cell. Returns the index of the selected list item. Remains 

adjustable when the woiksheet is locked. 

Stores a graphic. 

Draws an arc graphic fi-om a starting point to an ending point around a specified center 
point. 

Draws a circle graphic with a specified center, radius, name, and color. 

Draws a cross marie graphic with a specified center, angle, height, width, name, and color. 

Draws a line graphic between two points, with a ^ecified name and color. 

Draws a point graphic at a specified point in the image. 

Draw^ a rectangular region graphic, potentially rotated and curved. 

Draws a string graphic at a specified point. 

Puts a status display in a cell. Green if positive; yellow if 0.00; red if negative. 


^ A ► Graphics: Button function 
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Description Puts a labeled button control, Q, in a cell. Returns 1 .00 when clicked, 0.00 otherwise. 
Heading Graphics/Controls 
Syntax Button(Name) 

Inputs Name A text label for the button. 

NOTE In-Sigjit displays as much of the button label as it can without hiding an 

occupied cell. If the label is too long to fit in one cell and the adjacent cells 
are unoccupied, In-Sight displays the entire label. If the adjacent cells are 
occupied, it truncates the label at the first occupied cell. 

Returns 1 .00 when clicked; 0.00 otherwise. 

Emits Nothing 

Errors Invalid parameter. 

Comments To graphically control the value of a fiinction parameter — for example as part of an 

operator interface — reference a ButtonQ cell finom that parameter. The control remains 
adjustable even vAien the worksheet is locked. 

The referencing parameter typically is a "flag" toggle, trigger, or other parameter that 
accepts 0.00 for OFF or 1 .00 for ON, making the button a graphical proxy for the flag. 
ButtonQ returns a 0.00 or a 1 .00 even if the referencing item is not a flag. In that case, the 
result of clicking the button is the same as setting the item to 0.00 or 1 .00 by any other 
method. 


See Also 


ButtonQ is similar to CheckBoxQ but nonpereistent You commonly use ButtonQ to trigger 
one-time operations such as training a model. 

NOTE After you define a button, you cannot click X on its cell as a shortcut for opening 
the ButtonQ property sheet. To reopen the property sheet, you must click O to 
open the Edit menu, and then select Formula. 

Chart, CheckBox, ColorLabeK Dialog, Editlnt. ListBox, StaUis. Getting Started with 

Worksheet Graphics . 


► Graphics: Chart function 


Description 
Heading 
Syntax 
Inputs 


Puts a chart display in a cell, to plot the history of a value. 
Graphics/Displays 

Chart(Event, Value, Number, Name, Range Min, Range Max) 

Event An event that forces an iqxiate of the chart Must be a reference to a cell 

containing Acquirelmaee (the default). Button, or Event . 
Value The value to plot, typically a cell reference. 

Number Number of time increments to plot 
Name Name of the chart, a string. 

Range Range to display. If Min and Max both equal 0.0, ChartQ automatically 

— Min assigns a range, based on recent values. If either Max or Min is non-0.0, 

— Max then ChartO observes the requested values. 
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Returns 
Emits 
Errors 
Example 


0.00 on success. 
Nothing. 

Invalid parameter. 


Hi 


B^^I^TOil^ifiaPRga^coro ^^mvH d^osmf: 



Comments 


See Also 


If the row containing the chart already contains a value, then the chart ^phic hides the 
value. The chart does not destroy any data, but you can't see other values in the row 
because the chart is in the way. You can move from cell to cell in the hidden row, keeping 
track of the column through the highlight in the column header. References to the hidden 
cell remain intact 

This situation creates a risk of confusion. For example, if you clear the ChartQ cell and 
accidentally select a hidden ceU, then you lose the data in the hidden ceU. Consider 
adopting the habit of creating charts in empty rows. 
ColorLabeL Dialog . Stams, Getting Started with Charts 


^ A ► Graphics: CheckBox function 

Description Puts a labeled check box control in a cell. When ON p \ returns 1 .00; when OFF (D), 

0.00. Typically referenced to set a toggled value. 
Heading Graphics/Controls 
Syntax Checkbox(Name) 

Inputs Name A text label for the check box. 

Returns 1.00 when ON, 0.00 when OFF. 

Emits Nothing. 

Errors Invalid parameter. 

Comments To graphically control the value of a parameter— for example as part of an operator 
interface— reference a CheckBoxQ ceU from that parameter The control ranains 
adjustable even when the worksheet is locked. 

The referencing parameter is typically a toggle that accepts 0.00 for OFF or 1 .00 for ON, 
making the check box a graphical proxy for the toggle. CheckBoxQ emits a 0.00 or a 
1 .00 even if the referencing item is not a toggle, hi that case, the result of clicking the 
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See Also 


check box is the same as setting the item to 0.00 or 1 .00 by any other method. 
ButtonO is similar to CheckBoxQ but non-persistent. 

NOTE After you define a check box, you cannot click X on its cell as a shortcut for 

opening the CheckBoxQ property sheet. To reopen the property sheet, you must 
click O to open the Edit menu, and then select Formula. 

Button. Dialof!. Editlnt. ListBox. Getting Started with Worksheet Graphics . 


^ A ► Graphics: ColorLabel function 


Description 
Heading 
Syntax 
Inputs 


Returns 

Emits 

Example 

Em>rs 
Comments 
See Also 


Puts a text string of a specified color in a cell of a specified color. 
Graphics/Displays 

CoIorLabel(Name, ForeColor, BackColor) 
Name A string to display. 

ForeColor A color for the string. 
BackColor A color for the cell. 
0.00 on success. 
Nothing. 


Red Text eue 


Green 


Invalid parameter. 
None. 

Button. Chart, CheckBox. Editlnt, ListBox. Getting Started with Worksheet Graphics , 


A ► Graphics: Dialog function 


Description 

Heading 

Syntax 

Inputs 


Creates a a customized woiicsheet view accessed by a labeled button. 
Graphics/Controls 

Dialog(Name, Position, Force Defaults, Fonnula Bar, Column Headers, Row Headers, 
Grid Lines, Scroll Range, Top-Left Cell, Active Cell) 


Name 
Position 
— ^Row 
— Column 
—High 
—Wide 
Force 
Defaults 


A text label for the button that switches to the worksheet view. 
On-screen location and size of the worksheet view. Row and Col 
define the top-left point by offsets fiom the Image origin, in pixels. High 
and Wide are the height and width, in pixels. 


Forces the worksheet view to look and act like the full-size standard 
worksheet When ON, Force Defaults overrides subsequent 
oarameters. 
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Returns 
Emits 
Errors 
Comments 


Formula Bar 

Column 

Headers 

Row Headers 

Grid Lines 

Scroll Range 

— Enable 

—Start 

—End 

Top-Left 

Cell 

Active Cell 

???? 
Nothing. 


ON enables the formula bar. 

ON enables the column headers (A through Z). 

ON enables the row headers (0 through 999). 

ON enables the grid lines drawn on the worksheet. 

Restricts scrolling in the view window to a specified range of cells. 

Enable ON limits scrolling, and OFF permits scrolling for the entire 

worksheet. When ON, Start is the top-left cell accessible by scrolling 

and End is the bottom-right cell accessible by scrolling. 

The worksheet cell placed in the top-left comer of the view window. 

The woiksheet cell highlighted after switching to the view window. 


Invalid parameter. 

DialogO lets you create one or more window-like views into the woiksheet, typically as 
part of an operator interface. By placing other controls such as buttons or list boxes inside 
the viewed region, you can create dialog-box-like areas for operator use. For each view: 


1. 


2. 


3. 


Define the on-screen location and size of the window through the row and column 
of the top-left point and a height and width in pixels. 

Enable or disable various woiksheet attributes (formula bar, row headers, column 
headers, gridlines, and so on.) 

Define the range of worksheet cells visible through the window, the top-left visible 
cell, the active cell, and so on. 


After defining the view window, DialogO puts a labeled button in the ceU. Clicking the 
button opens the view window: 

(Row, Column) 
Formula bar 
Column headings 
Row headings 
Grid lines 



See Also 


NOTE Aftar you define a view window, you cannot click X on its cell (the activation 
button) as a shortcut for opening the DialogO property sheet. To reopen the 
property sheet, you must click O to open the Edit menu, and then select Foimula. 

Button, Chart, Status, Getting Started with Worksheet Graphics . 
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^ A ► Graphics: EditFloat function 


Description 

Heading 

Syntax 

Inputs 

Returns 
Emits 
Enrois 
ET^ample 


Comments 


Puts a numeric edit box control in a cell. Returns a floating-point value constrained to a 
specified range. Remains adjustable when the worksheet is locked. 
Graphics/Controls 
EditFloat(Min, Max) 

Min The minimum value for the numeric selection graphic. 

Max The maximum value for the numeric selection graphic. 

A floating-point value between Min and Max. 
Nothing. 


This function gives you a way to let the operator input a floating-point value even when 
you lock the woiksheet. The selection graphic remains adjustable even when the 
worksheet is locked 


NOTE After you define a numeric selection graphic, you cannot click X on its cell as a 
shortcut for opening its property sheet To reopen the property sheet, you must 
click O to open the Edit menu, and then select Formula. 
See Also Button, Chart CheckBox. ColorLabel. Dialog. Editlnt. EditString. ListBox. Status. 

Getti'njj Started with Worksheet Graphics . 



^ A ► Graphics: Editint function 


Description Puts a numeric edit box control in a cell Returns an integer constrained to a specified 

range. The value remains editable even when the worksheet is locked. 
Heading Graphics/Controls 
Syntax EditInt(Min, Max) 

Inputs Min The minimum value for the intega* selection graphic. 

Max The maximum value for the integer selection graphic. 

Returns An integer between Min and Max. 

Emits Nothing. 
En*ors Invalid parameter. 
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Exanple 


Comments 


See Also 


iA1= Editlnt(0,10) 

i-- ■ 



) 0 



1 1 




This function gives you a way to let the operator input an integer even when you lock the 
worksheet. Remains adjustable even when the worksheet is locked 

NOTE After you define a integer selection graphic, you cannot click X on its cell as a 
shortcut for opening its property sheet To reopen the property sheet, you must 
click O to open the Edit menu, and then select Formula. 

Button, Chart, CheckBox. ColorLabcU Dialog, EditFloat EditStrinp. ListBox, ^t^h^ 

Geftins Started with Worksheet Graphics. 


< A 


► Graphics: EditString function 


Description 

Heading 

Syntax 

Inputs 

Returns 

Emits 

Errors 

Exanple 


Comments 


See Also 


Puts a text edit box control in a cell. Returns a string constrained to a specified range. The 

value remains editable even when the woiksheet is locked. 

Graphics/Controls 

EditString(MaxStringLen) 

MaxStringLen Ndaximum length for the user-edited string, in chaiactere. 

A string up to MaxStringLen characters long. 

Nothing. 





c 




n li^Mv Strcna : 



^ J ^„ ^yn^^^^.^^ uipul a icAi :>uiiig cvcii wnen you loCK tr 

worksheet. Remains adjustable even when the worksheet is locked 

NOTE After you define a string selection graphic, you cannot click X on its cell as a 

shortcut for opening its property sheet To reopen the property sheet, you must 
click O to open the Edit menu, and then select Fomiula. 
Button, Chml, aaIo& EditFloat Editlnt, CheckBox. ColorLabel. ListRox grntnc^ 
Getting Started with Worksheet Graphics , ' ' 


A ► Graphics: ListBox function 
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Description 
Heading 
Syntax 
Inputs 

Returns 
Emits 
Errors 
Example 


Comments 


See Also 


Puts a list box control in a cell. Returns the index of the selected list item. 

Graphics/Controls 

ListBox(String 1 , . . . , StringN) 

Stiingl . . . Labels for the list items. Two or more strings or references to cells 

StringN containing strings. 

Index of the selected list item. The first item is 0.00. 

Nothing 


lA2= 











1^^ 

first - > 

..second . . 

itjiirdr^: . 

1 2 

► first j 



1 3" 

-second i 



U4 

^t^fd^.J 




To graphically control a function parameter that accepts a list of values — for example as 
part of an operator interface — reference a cell containing ListBoxQ from that parameter. 
The control remains adjustable even when the worksheet is locked. 

From ListBoxQ, assign names for the enumerated parameter values (Stringl, and so on). 
ListBoxQ then creates a list box associated widi the cell. When the user selects the list 
box, it pops up, so that the user can select one of the enimierated items. 

NOTE After you define a list box, you cannot click X on its cell as a shortcut for opening 
the ListBoxO property sheet. To reopen the property sheet, you must click O to 
open the Edit menu, and then select Formula. 

Button. Chart. CheckBox . ColorLabeL Dialog. Edithit Status, Genins Started with 

Worksheet Graphics , 


^ A ► Graphics: Plot structure 

Description Stores a graphic. 

Values Plot has no internal values that are read individually by Data Access fiinctions. 

Comments Returned by graphics stmctures that store a graphic. 

See Also PlotAic. PlotCircle. PlotCross, PlotLine. PlotPoint. PlotRegion. PlotString. Gettine 

Started Plotting Graphics . 


^ A ► Graphics: Plot Arc function 
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f 


Description 


Heading 

Syntax 

Inputs 


Returns 
Emits 
EiTors 
Coniments 


See Also 


Draws an arc graphic from a starting point counterclockwise to an ending point around a 
specified center point If necessary, fits an arc by averaging the center-to-end point 
distances. 
Graphics/Image 

PlotArc(Arc, Name, Color, Show) 

Arc The arc, defined by row and column coordinates for the center point, 

—Center Row starting end point, and ending end point, in pixels fiom the in^aee origin. 
— Centered t> &" 

— Start Row 
—Start Col 
— ^End Row 
— End Col 
Name 
Color 
Show 
Plot 
Nothing. 
Invalid parameter. 

. If the center point and end points define a circle, then PlotArcQ draws the arc 
exactiy as defined. If the end points do not fell on a circle with the specified center 
then PIotArcO averages the two center-to^d point distances and fits an arc from ' 
the resulting circle. 

. PIotArcO draws the arc counta-clockwise fiom the Start point to the End point: 


A text label for the graphic. A string or a referoice to one. 

A color, selected fix)m a list 

ON to enable the arc graphic; OFF to disable it. 

On success, a Plot strucnire. which stores the graphic. 


Yes 


No 



Counterclockwise Clockwise 


PlQtCircle, PlotCross, Pjoajr^ Plogoint PlotRegion. PlotStrini?. Getting Started 
Pfottintr Graphics . 


^ ^ ► Graphics: PlotCircle function 


Description Draws a circle with a specified center, radius, label, and color. 

Heading Gr^hics/hnage 

Syntax PlotCircle(Circle, Name, Color, Show) 
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^ A ► Text: Overview 

The Text functions manipulate text strings in various ways. For example, you can find text inside a string, 
replace text inside a string with new text, convert a string to lowercase or UPPERCASE, compare two 
strings, and so oa Each string can contain up to to 255 alphanumeric characters (bytes) and must be 
enclosed in quotes. The Text functions are in general case-sensitive. Common uses include manipulating 
strings for serial communications or for on-screen display. 

This section introduces the Text functions, discussing the foDowing topics: 

• Using the Text Functions 

• Text Functions Reference . 

Any cell in the In-Sight worksheet cell can hold a string, which you insert or edit though the Formula Builder, 
as described in Enterim^ Text . A reference to an empty cell as a string is generally interpreted as a null 
string. For functions that process more than one string, the maximum number of characters per cell is 2048. 

Each character in a string has a zero-based index. The first character is number 0.00, the second is number 
1 .00, and so on. Text operations that depend on the location of a character inside a string express the 
locations in terms of these zero-based indices. 

NOTE Functions that return strings cannot act as direct arguments for certain classes of fimctions. This 

restriction affects functions that retum structures (such as ExtractBlobsQ, FindPattemsQ, and many 
others), the lookup functions IfO and Choose(), and the worksheet graphics functions such as 
ButtonO and ListBoxQ- In these situations, place the string function in a distinct ceU and refer to that 
cell fix)m the conq)lex function. 



^ A ► Text: Using the Text Functions 

In this topic, you concatenate and format a string with the Sningf a representative Text function. The result 
looks like this: 


; A3= : Strhgf C^r/X^onfr is "JG2) 
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Thresh ^~ 




A^Brighr 
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tGbntrast is TO13078: 
















Other Text functions require similar steps. 
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► To Format a String with StringfQ 

1 - To illustrate StringfO in a machine vision context, start by setting up worksheet that computes a value. 
A convenient value for this exercise is the contrast result from a histogram. To obtain it: 

a. Acquire an appropriate image. EHmng development, you typically place a part sample under the 
test stand and snap a picture of it . Alternatively, to adjust the camera height, aperture, and 
focus, use live mode . 

b. From cell A2, click X to open the Fonnula Builder . 

c. From Vision Processing, open the Histogram heading, and then open the ExtractHistogram 
property sheet 

d. Click X on the Region heading, switching to the interactive Region cursor. Use the Control Pad 
to adjust the region to include a feature in the image. 

e. Click X to accept the region, and then click OK to close the property sheet. In-Sight computes 
the histogram and emits the Contrast and other values. 

2. From cell A3, click Xto open the Formula Builder. From the Text heading, click StringfO- 


To q^ecify the first parameter (the format), click the IgS^^I button to open the Text Entry dialog. 
Click O to toggle between UPPERCASE and lowercase. From the uppercase character set, select 
%, the percent sign. Click O to switch to lowercase, click s, and then click OK to accept the %s 
format 

Click the comma (,) character, ^\ilich is the d elimi ter between the first and second parameters. 


and similarly edit the string "Contrast is Note the 


To specify the second parameter, again click II 
trailing space. When done, chck OK. 
Click comma to place the del imite r between the second and third parameters. 


move the marquee to cell G2 (the Contrast value), and click X to 


8. For the third parameter, click 
accept the reference. 

9. Enter a closing parenthesis character to mark the end of the formula. 

10. Click OK to accept the finished formula. StringfO concatenates its parameters and formats the result 
string in the %s format: 



i -: A- ■ 
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The %s format displays the value at a higher precision than that of tiie emitted formula in G2. 


^ A ► Text: Function Reference 
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Concatenate 

Exact 
Find 

Left 
Len 
Lower 
Mid 

Replace 

Ritjit 

Strcspn 

Stringf 
Strspn 

Strtol 

Substitute 

Token 
Trim 

Upper 
Value 


Concatenates a variable number of text or numeric parameters. Returns the concatenated 
string. 

Compares two strings and returns Tme (LOO) if they are identical. Case sensitive. 

Finds a string inside another string, starting at a specified index. Returns the zero-based 

index of the first matching character. Case sensitive. 

Returns the left-most characters fi*om a text string. 

Returns the number of characters in a text string. 

Converts a text string to lowercase; returns the lowercase string. 

Returns a specified number of characters fiom a specified location in a text string. 

Replaces characters inside a text string with new characters. Returns the edited string. 

Returns the right-most characters fix)m a text string. 

Searches a string for the first character included in a specified set of characters. Returns 

the zero-based index of the first matching character. Case sensitive. 

Formats a string in one of these formats: %c, %d, %e, %E, %f, %o, %s, %u, %x, or %X. 

Searches a string for the first character not in a specified set of characters. Returns the 

zero-based index of the first non-matching character. Case sensitive. 

Converts a string that starts with an integer to its integer value, including hexedecimal and 

octal values. Ignores subsequent non-integer characters. Truncates floating-point inputs. 

Replaces text in a string with new text Returns the edited string. Replaces all instances 

unless you specify an instance number. 

Returns a ^Decified instance of text fi-om a list, with a specified delimiter. 

Removes leading and trailing spaces fiiom a text string Also rranoves extra internal spaces, 

leaving one space between words. Returns the edited string. 

Converts a text string to UPPERCASE; returns the uppercase string. 

Converts a text string that starts with with an integer to its integer value. Ignores 

subsequent non-integer characters. 


^ A ► Text: Concatenate function 


Description 
Heading 
Syntax 
Inputs 

Returns 

Emits 

Errors 


Concatenates its parameters, returning the concatenated string. 
Text 

Concatenate(Argl , [ ArgN, . . . ] ) 

Argl . . . One or more text strings or numeric values. Any numeric values are 

automatically convaled to strings. 
The formatted string, concatenated fix)m Argl . . . ArgN. 
Nothing. 

• Invalid parameter, 

• Result string exceeds 255 characters. 


Examples 


Concatenate("Combine "these", "strings") returns "Combine these strings". 
Concatenate("Converts ", "numerics ", 1, 2, 3) returns "Converts numerics 123" 
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Comments 
See Also 


None. 

StrtoK Vaiue 


^ A ► Text: Exact function 


Description 
Heading 
Syntax 
Inputs 

Returns 

Emits 
Errors 
Exanple 


Comments 
See Also 


Compares two text strings and returns True (LOO) if they are identical. Case sensitive. 
Text 

Exact(Textl,Text2) 

Textl A text string or a reference to one. 

Text2 A text string or a reference to one. 

1 .00 The strings are exactly identical. 

0.00 The strings differ. 

Nothing. 

Livalid parameter. For example, Textl or Text2 is not a string. 

• Exact("Same", "Same") returns 1.00. 

• Exact("Same", "Different") returns 0.00. 

. Exact("DIFFERENr\ "different") returns 0.00. 

None. 
Len 


^ A ► Text: Find function 


Description 

Heading 

Syntax 

Inputs 


Returns 


Emits 
Errors 


Finds a string inside another string, starting at a specified index. Returns the zero-based 

index of the first matching character. Case sensitive. 

Text 

Find(FindText, SearchText, [StartChar]) 

FindText The text to find. A text string or a reference to one. 

SearchText The string to search for FindText. A text string or a reference to one. 

StartChar The starting location in SearchText. A zero-based character index. 

• Index of the fu^t matching character. Zero-based. 

• -1, indicating "not found." 

Nothing. 

• Invalid string parameter. 

• StartChar <0. 
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Exanple 


Comments 
See Also 


• Find("d", "abcdefg") returns 3.00, 

• Find("D", "abcdefg") returns -1 .00 (not found). 

• Find("c", "abcabcabc", 4) returns 5 00. 

The -1 return value lets you distinguish between "not found" and "invalid parameter/ 
Replace, Strcspn, Strspn, Substitute. Token 


^ A ► Text: Left function 


Description 
Heading 
Syntax 
Inputs 

Returns 

Emits 

Errors 


Returns the left-most characters fh>m a text string. 
Text 

Left(Textl . NumChars) 

Textl A text string or a reference to one. 

NumChars The number of characters to return. 
The left-most characters. A string. 
Nothing. 

• Invalid string parameter. 

• NumChars < 0. 


Example 
Comments 

See Also 


LeftC'This is a string", 4) returns "This". 

If NumChars exceeds the number of characters actually in Textl, LeftQ returns the 
entire string, not an mor. 
Mid, Right 


^ A ► Text: Len function 


Description Remms the number of characters in a text string. 

Heading T©ct 

Syntax Len(Textl) 

Inputs Textl A text string or a reference to one. 

Returns Length of Text 1 , in characters. 

Emits Nothing. 

Errors Invalid string parameter. 

Exanple LenfThis is a string") returns 1 6.00. 

Comments None. 

See Also Exact 
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^ A ► Text: Lower function 


Description Converts a text string to lowercase; returns th^ lowercase string. 

Heading Text 

Syntax Lower(Textl) 

Inputs Textl A text string or a reference to one. 

Returns The lowercase text string. 

Emits Nothing. 

Errors Invalid string parametCT. 

Exanple Lower("AbCdEfG") returns "abcdefg". 

Conunents None. 

See Also Upper . 


^ A ► Text: Mid function 


Description 
Heading 
Syntax 
Inputs 


Returns 

Emits 

Errors 


Returns a specified number of characters from a specified location in a text string. 
Text 

Mid(Textl, StartChar, NumChars) 

Textl The source string. A text string or a reference to one. 

StartChar The starting location in Textl. A zero-based character index. 
NumChars The number of characters to extract. 
The characters extracted from Textl. 
Nothing. 

• Invalid string par^ameter. 

• StartChar or NumChars < 0- 


Exanple 


Comments 
See Also 


MidCThis is a string", 0, 7) returns 'This is". 
MidCThis is a string", 1 , 8) returns 'Tiis is a". 


None. 
Left. Right 


^ A ► Text: Replace function 
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Description 
Heading 
Syntax 
Inputs 


Returns 

Emits 

Errors 


Example 


Comments 
See Also 


Replaces text inside a string with new text. Returns the edited string. 
Text 

Replace(SrcText, StartChar, NumChars, NewText) 

SrcText Source text. A text string or a reference to one. 

StartChar Index of the first character to replace. Zero^based. 

NumChars Number of characters in to replace. 

NewText Text to inrvcrt in Textl . A text string or a reference to one. 

The edited string. Textl UKxlified by Text2. 

Nothing. 

• Invalid string parameter. 

• StartChar or NumChars < 0. 

• Result string exceeds 255 characters. 

• Replace (*This is a string", 0, 4, *That") returns "That is a string." 

• Replace ('This is a string", 8, 1, "a changed") returns "This is a changed string.* 

None. 

Find Strcspn. Strspn , Substitute. Token 


^ A ► Text: Right function 

Description Returns the right-most characters fix>m a text string. 

Heading Text 

Syntax Right(Textl, NumChars) 

h^>uts Textl A text string or a reference to one. 

NumChars The number of characters to return 
Returns The right-most characters. A string. 

Emits Nothing. 
Errors # Invalid string parameter. 

• NumChars < 0. 

Exanple Ri^t('This is a String", 4) returns "ring". 

Comments If NumChars exceeds the number of characters actually in Textl , RightQ returns the 

entire string, not an error. 
See Also Left, Mid 


^ A ► Text: Strcspn function 
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Description 

Heading 

Syntax 

Inputs 


Returns 


Searches a string for the first character included in a specified set of characters. Returns 

the zero-based index of the first matching character. Case sensitive. 

Text 

Strcspn(SrcText, CharList) 

SrcText A string, or a reference to one, to check against CharList. 
CharList A set of characters to test for inclusion. Order and duplication do not 
matter. No delimiter. For example, "ABC" means "A" or "B" or "C". 

• hidex of the first character in SrcText that is present in CharList. Zero based. 

• If no characters in SrcText are present in CharList, returns the length of SrcText. 


Emits Notfiing. 

Errors Invalid string parameter. 

Exanple • Strcspn('This is a string", "QWERTY") returns 0.00. 

• Strcspn("This is a string", "qwerty") returns 1 1 .00. 

• Strcspn("abc", "xyz") returns 3.0, which is the length of the first parameter. 

Comments Similar to strcspnQ in ANSI C. Strspn(), in contrast, searches a string for the first 

character excluded from a specified set of characters. 
See Also Find. Replace, Strspn, Substitute. Token 


^ A ► Text: Stringf function 


Description Formats a string in one of these formats: %c, %d, %e, %E, %f, %o, %s, %u, %x, or %X. 

Heading Text 

Syntax Stringf{[%format,] Text 1 ) 

Inputs %format A text string rq^resenting a format specifier, one of: 


%c Char. 

%d Decimal integer. 

%e or %E Scientific notatiorL 

%f Floating-point Default (except that trailing zeros are 

trimmed). 

%o Octal. 

%s String. 

%u Unsigned integers. 

%x or VoX Hexadecimal. 


Textl ... One or more text strings. Numeric values are automaticaUy converted to 
strings. 

Returns The formatted string. Textl in %format. 

Emits Nothing. 
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Errors 


Examples 


Comments 


• Invalid parameter. 

• Result string exceeds 255 characters. 

• ??CHECK THESE EXAMPLES 

• Stringf{"%d"3) returns "3". 

• Stringf{"decimal:%d is hex:%X";Z55;255) returns "decimal:255 is hex:FF". 

• Stringf("PI = %f •J>i) returns "PI = 3.141593". 

• Stringf{"Char code of *'oc' is rod^'/W/'A") returns "Char code of W is '65"'. 

• In-Sight*s StringfO function is similar to the C-Ianguage sprintfO functioa The 
%format specifiers therefore support several options controlling precision and other 
attributes. Their more general syntax is: 

% [flag] \min-Jleld\^recision \con version-letter 

where: 


o flag is a minus sign (— ) to left-justify or a zero (0) to pad. C's # flag is 
unsupported. 

o min-field is a decimal integer that defines a minimum width in characters. 

o .precision is a decimal integer that controls precision: the minimum number 
of digits for %d, %i, %o, %u, and %x; fee digits to the right of the decimal 
for %e, %E, and %f; and the maximum number of charactas for %s. 

o conversion letter is one of the conversion operations (c, d, e, E, f, o^ s, u, 
X, or X). 

C's "size" option is unsupported. For more information about formatting, consult a 
C-Ianguage text such as Cy4 Reference Manual by Harbison and Steele. 
To convert from text to numbers, use StrtolQ or ValueQ. 


See Also 


Concatenate, StrtoK Value 


^ A ► Text: Strspn function 


Description Searches a string for the first character not in a specified set of characters. Returns the 

zero-based index of the first non-matching character. Case sensitive. 
Heading Text 
Syntax Strspn(SrcText, CharList) 

Inputs SrcText The string, or a reference to one, to check against CharList. 

CharList A set of characters to test for exclusion. Order and diqjlication do not 
matter. 
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Returns 


Index of the fiiist character in SrcText that is absent from CharList. Zero-based. 
If all characters in in SrcText are also in CharList, StrspnO returns the length of 
SrcText. 


Emits 
Errors 
Example 


Comments 
See Also 


Nothing. 

Invalid parameter. 

• Strspn('This is a string", "xyz") returns 0.00. 

• StrspnCThis is a string", "QWERTY") returns 1 .00. 

• StispnCThis is a string", 'This") returns 4.00. 

• StrspnCThis is a string", *This is a string") returns 1 6.00 (the length of the first 
parameter). 

• Stispn('This is", 'This is a string") returns 7.00 (the length of the first parameter). 

Similar to strspnQ in ANSI C. StrcspnQ, in contrast, searches a string for the first 
character included in specified set of characters. 
Find Replace, Strcspn, Substitute. Token 


^ A ► Text: Strtol function 


Description Converts a string that starts with an integer to its integer value, including hexadecimal and 
octal values. Ignores subsequent non-integer characters. Truncates floating-point inputs. 
Heading Text 
Syntax Strtol(IntText) 

Inputs IntText A text string that rq>resents a numeric value, or a reference to one. Strings 

starting with Ox or OX are interpreted as hexadecimal, and strings starting 
with zero (0) are interpreted as octal. 

Returns The integer value obtained fix>m IntText, displayed as a floating-point value. 

Emits Nothing. 

Errors Invalid string parameter. For example, IntText does not start with a digit. 

Example • Strtol(" 1 234") returns the value 1234, displayed as 1 234.000. 

• StrtoK" 1 234abcd") returns the value 1 234, displayed as 1 234.000. 

• Strtol(" 1234.567") returns the value 1234, displayed as 1234.000. 

Conmients • In-Sight's StrtoIQ fimction is similar to the C-language strtoIQ fimction. It 

consequently interprets a string starting with Ox or OX as a hexadecimal value and a 
string starting with zero (0) as an octal value. Its handling of a leading zero differs 
fi-om that of the worksheet. In the worksheet, In-Sight interprets "010" as the 
decimal value tea But StrtoIQ interprets 010 as the octal value 10, equal to the 
decimal value eight. In-Sight retains this aspect of the C-Ianguage strtoIQ function 
for the benefit of those needing to read octal values and familar with the C-language 
convention. 

• ValueQ is similar to StrtoIQ, except that ValueQ does not recognize the 0, Ox, and 
OX prefixes as octal and hexadecimal. 
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See Also 


• To convert from numbers to text, use StringfO. 
Concatenate. Strincf, Value 


^ A ► Text: Substitute function 


Oesciiption Replaces text in a string with new text, returning the edited string. Rq)laces all instances 

unless you specify an instance number. 
Heading Text 

Syntax Substitute(SrcText, OldText, NewText, [Instance]) 

Inputs SrcText The source string. A text string or a reference to one. 

OldText The sequence of characters to be replaced inside SrcText. A text string or 

a reference to one. 
NewText A string of characters to substitute for OldText. 
Instance An instance number. A zero-based index: 0 for the first match, 1 for the 
second, and so on. If the parameter is omitted, SubstituteQ replaces all 
instances. 
Returns The edited string. 

Emits Nothing. 
Errors • Invalid parameter. 

• Result string exceeds 255 characters. 

Exanple • Substitute ("abcdefabcdef "abc", "XYZ") returns "XYZdeDCYZdef . 

• Substitute ("abcdefabcdef, "abc", "XYZ", 1) returns "abcdefXYZder. 

• Substitute ("abcdefabcder, "abc", "XYZ", 5) returns "abcdefabcdef - (No change, 
because the index 5 is not present in the soxirce string.) 

Comments None. 

See Also Find. Replace. Strcspn. Strspn, Token 


^ A ► Text: Token function 

Description Returns a specified instance of text from a list, with a specified delimiter. 
Heading Text 

Syntax Token(Textl, Delimiter, Instance) 

Inputs Textl A string containing a list of text items, separated by Delimiter. 

Delimiter A string defining a delimiter within Textl . 

Instance The instance number to select. Zero-based: 0 for the first instance, 1 for the 
second, and so on. 
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Returns The selected instance. A string. 

Emits Notiiing, 

En^ors • Invalid string parameter. 

• Instance <0. 


Exanple 


Comments 
See Also 


• ??Token("a b, c, d", " 2) returns "c". 
. ??Token(" a b, c, d", " 2) returns "c". 

None. 

Find Replace. Sircspn. Strspn. Substitute 


^ A ► Text: Trim function 


Description 

Heading 

Syntax 

Inputs 

Returns 

Emits 

Errors 

Exanple 


Comments 
See Also 


Removes leading and trailing spaces from a text string. Also removes extra internal spaces, 

leaving one space between words. Returns the edited string. 

Text 

Trim(Textl) 

Textl A text string or a reference to one. 

The edited string. Textl without extra spaces. 
Nothing. 

Invalid string parameter. 

• Trim(" Remove outside spaces ") returns "Remove outside spaces". 

• Trim("Remove inside spaces") returns "Remove inside spaces". 

None. 

Find Replace. Substitute. Token 


^ A ► Text: Upper function 


Description Converts a text string to UPPERCASE; reUims the uppercase string. 

Heading Text 

Syntax UpperfTextl) 

Inputs Textl A text string or a reference to one. 

Returns The UPPERCASE text string. 

Emits Nothing. 

Errors Invalid string parameter. 

Exanple Upper("aBcDeFg") returns "ABCDEFG". 

Comments None. 

See Also Lower. 


SOOCtD: <W0 Oin445A2J_> 


Appendix I - Page 305 


wo 01/11445 PCT/USOO/22383 


^ A ► Text: Value function 


Description 

Heading 

Syntax 

Inputs 

Returns 

Emits 

Errors 

Exanrple 


Comments 
See Also 


Converts a text string that starts with an integer to its intega- value. Ignores subsequent 

non-integer characters. 

Text 

Value(NumText) 

IntText A text string that represents a number, or a reference to one. 
The numeric value obtained from IntText. A floating-point quantity. 
Nothing. 

Invalid string parameter. For example, IntText does not start with a digit 

• Value("1234") returns the value 1234, displayed as 1234.000 

• Value("1234abcd") returns the value 1234, displayed as 1234.000 

• Value("1234.567") returns 0.00 ??Said changed. Check this one.?? 

Similar to StrtolQ, but does not convert octal or hexadecimal. To convert from numbers to 
text, use StringfO. 
Concatenate. Stringf. Strto! 
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^ A ► Data Access: Overview 

The Vision Data Access functions return individual values fh)m the structures generated by other In-Sight 
functions. They underly the automatically emitted fonnuJas . You can usually obtain result values fix)m the 
emitted formulas and ignore the Data Access functions, which are listed in the Formula Builder under 
Advanced. In-Sight offers them to provide access to values that aren't emitted (for exan^le, the maximum 
and minimum row and column values for a blob) and to give you more control over the extracted data. 

This section introduces the Data Access functions, discussing the following topics: 

• Getting Started with Data Access 

• Data Access Function Reference . 

The exact result returned by a particular data access function depends on the referenced structure. For 
exanrple, in general GetMaxQ returns the maximum value fiom a structure — so, when pointed at a Delay 
structure, it returns the largest value currently in the buffer. 

Many stmctures store feature data extracted fix)m images. Each item has a zero-based index and a set of 
measured values. Most Data Access functions have an index parameter to specify the particular item of 
interest. The indexes defeult to 0.00, so omitting the index yields the first item in the structure. In a few 
situations, you supply two indices. For example, each edge in an Edges structure has two row values, one 
for each end point. When GetRowQ refers to an Edges structure, it therefore requires two indexes: one to 
specify a particular edge, and another to specify either the first or second end point. 


^ A ► Data Access: Getting Started 

Li this topic, you use the GetRow function to get a row coordinate — a value already available as an emitted 
fomiula — from a Blobs structure. You then use the GetNFound fiinction to get the number of blobs — a value 
not emitted and otherwise unavailable. The result looks like this: 


Six blobs found 


Two not found 


GetRow(A2,5) 
(same as emitted 
formula) 

GetNFound(A2) 
(returns number 
actually found) 
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The techniques shown here apply to all E>ata Access functions. 
^ To Get Data Values from a Structure 

1 . Acquire an appropriate image; For this exercise: 

a. Open the part sample image, print it, and return to this topic. Place the printed image under the 
camera. 

b. Click and release A, select Live from the System menu, and click X to enter live mode. 
Interactively adjust the image location, camera height, aperture, and focus until satisfied with the 
image. 

c. Chck A twice to exit live mode, acquire the last image, and return to the woricsheet 


To acquire a new image at any time, hold □ and click X 


2. Extract blob data from the image: 

a. From cell A2, click Xto open the Fomiula Builder . From Vision Processing, select Blob, 
and then open the ExtractBlobs property sheet. 

To define the region of interest, click the Region heading. In-Sight hides the worksheet and 
displays the Recion cursor . Using the Control Pad, surround the part image, which has at most 
six blobs (four small round holes, one larger rectangular hole, and the entire perimeter). Chck X 
to return to the property sheet. 

Increase the Number To Find value to "8" (more than the number e^qsected). 
Click OK to extract the blobs. ExtractBlobsQ analyses the image for blobs that fit the selection 
criteria, draws an outline around them, and emits a block of fomiulas containing individual blob 
data values: 


b. 


c. 
d. 


Blobs object 
(stores feature data) 


Emhted formulas 

iVERR (no data) 
Region graphic 



Each Blob has an index, starting with 0 (displayed as "0.(X)"), used to specify a particular blob 
when you call a Data Access function. Here, ExtractBlobs() sought eight blobs (the Number to 
Find value) but actually found only six that met the selection criteria. Therefore, blobs 0 through 
5 contain measured values, but blobs 6 and 7 are empty, as indicated by #ERR. 
Show the equivalence of the emitted fomiulas and the Data Access functions: 

a. On cell AlO, click X to open the Formula Builder. Open Advanced, move to Vision Data 
Access, open the Blobs heading, select GctRow. and click X GetRowQ does not have a 
property sheet, histead, you edit its two parameters directly from the Formula Builder. 

b. The first parameter is a reference to stmcture to serve as the data source. To create a relative 
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, move the marquee to A2 (the Blobs structure^ and click X to accept the 


reference, click 
reference. 

c. Enter a comma (,) character as the delimiter between the first and second parameters. 

d. The second parameter identifies the blob of interest through its index. The first blob is blob 0, 
so the sixth is blob 5. To select it, enter the digit 5. 

e. Enter a close-parenthesis character to mailc the end of the formula, and then click OK to 
accept it. GetRow() retimis the row value for the sixth blob to A 10. The value should equal the 
value in C7, which contains an emitted formula for the sixth blob's row. The Data Access 
functions underlie the emitted formulas, which are automatically added to the worksheet as a 
convenient way to expose the data in structures. There is no difference between the emitted 
formulas and equivalent formulas built by hand with the Data Access functions. 

Some structures contain values not automatically emitted to the worksheet. For example, the Blobs 
structure stores the number of blobs actuaUy found. To get this value: 

a. From All, open the Formula Builder. If necessary, open Advanced, move to Vision Data 

Access, open the Blobs heading, select GetNFound. and click X Like GetRowQ, 

GetNFoundO does not have a property sheet. 


c. 


To create a reference to the Blobs structure, click !L™J, move the marquee to A2, and click X 
Because GetNFoundQ has only one parameter, Ir>Sight supplies the close-parenthesis 
character. 

Click OK. Here, GetNFoundQ returns 6.00, indicating that ExtractBlobsQ actuaUy found six 
blobs that met the selection criterion: 


Six blobs found 
Two not found 


GetRow(A2,5) 
(same as emitted 
formula) 

GetNFDund(A2) 
(returns number 
actually found) 



^ A ► Data Access: Function Reference 
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GetAngle 

GetArea 

GetCoi 

GetColor 

GetCoimt 

GetCurve 

GetDistance 

GetElongation 

GctHiiih 

GetHoJes 

GetMax 

GetMaxCol 

GetMaxRow 

GetMean 

GctMin 

GetMinCoi 

GetMinRow 

GetNFoiind 

GetPerimeter 

GetPixelValue 

GetRadiiis 

GetRow 

GetScale 

GetScorc 

GetSDev 

GetSpread 

GetSuni 

Get Value 

GetWide 


Returns an angle value, in counterclockwise degrees, from a specified structure. 
Returns an area value, in pixels, from a specified structure. 

Returns a column coordinate from a structure, in Pixel or Worid units, reflecting the 
structure. 

Returns the color value, 0.0 for black or 1 .0 for white, for a specified blob. 
Returns a count value from a specified structure. 

Returns a curvature value, in counterclockwise degrees, fix)m a structure. 
Returns a distance value (the length of a line segment) from a structure. 
Returns an elongation value (the ratio of major to minor axes) for a specified blob. 
Returns a height value, in pixels, from a structure. 

Returns the number of holes (background-colored areas) in a specified blob. 
Returns the maximum value from a specified structure. 
Returns the maximum (right-most) column coordinate from a structure. 
Returns the maximum (bottom-most) row coordinate hom a structure. 
Returns the average (arithmetical mean) from a specified structure. 
Returns the minimum value from a specified stmcture. 

Returns the minimum (l^f^-most) column coordinate from a specified structure. 

Returns the minimum (top-most) row coordinate from a specified structure. 

Returns the number-found value from a specified structure. 

Returns the perimeter, in pixels, from a specified structure. 

From an Image stmcture, returns the grayscale value for a specified point. 

Returns the radius of a specified circle or arc, in pixels. 

Returns a row coordinate from a structure, in Pixel or World units, reflecting the structure. 
Returns a scale value (the size of a matched instance, as a percentage of the model) from a 
specified stmcture. 

Returns a score value, 0 through 100, from a specified structure. 

Returns the standard deviation value from a specified stmcture. 

Returns the spread value (a rough measure of compactness) for a specified blob. 

Returns a sum value from a specified structure. 

Returns the number of values from a ^>ecified structure. 

Returns a width value, in pixels, from a structure. 


^ A ► Data Access: GetAngle function 

Description Returns an angle value, in counterclockwise degrees, from a specified structure. 
Heading AdvancedA^ision Data Access 

Syntax GetAngle(Struct, [Index]) 

^P"^ Struct A reference to a stmcture that contains an angle value. 

Index A zero-based index into Struct. Default = 0, the first item. 

Returns Angle, in counterclockwise degrees. Measured from the image row axis or the World X 

axis, reflecting the values in Struct. 
Emits Nothing. 
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Errors ?Invalid structure or index?. 

Comments Available from the Blobs. Cross, Dist, Fixnire, Patterns, and Region structures. See each 

structure's documentation for details about the returned values. 
See Also GetCol. GetCurve. GetHi|2h. GetRow. GetWide . 


^ A ► Data Access: Get Are a function 

Description Returns an area value, in pixels, fh>m a specified structure. 
Heading Advanced/Vision Data Access 

Syntax GetArea(Stmct, [Index]) 

Inputs Struct A reference to a structure containing an area value- 

Index A zero-based index into Struct. Default - 0, the first item. 

Returns Area. ?Always in pixels, even if the source structure is in World units.??. 

Emits Nothing. 
Errors Invalid structure or index. 

Comments Available from the Blobs structure . See its documentation for details about the returned 
value. 

See Also Blobs structure, GetColor. GetElongation. GetHoles, GetPerimeten GetSnread . 


^ A ► Data Access: GetCol function 


Description 

Heading 

Syntax 

Inputs 


Returns 

Emits 
Errors 
Comments 


Returns a colunm coordinate fix)m a structure, in Pixel or World units, reflecting the 
structure. 

AdvancedA^ision Data Access 
GetCol(Struct, [Index I], [Index2]) 

Struct A reference to a stnicture containing a column value. 

Index 1 An zero-based index into Struct, identifying the item of interest 

Index2 Edges only. A zero-based index identifying the end point: 0 for the first end 

point or 1 for the second end point. 
Column value. In pixels from the image origin or from the World X axis, reflecting the 
source structure. 
Nothing. 

??Invahd structure or index. 

Available from the Blobs. Circle. Cross. Dist, Edges. Fixture, Line. Point. Patterns, and 
Reidon structure. See each snucture's documentation for details about the returned value. 


See Also 


GetAngle. GetCurve. GetHigh, GetRow, GetWide . 
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^ A ► Data Access: GetColor function 


Description Returns the color value, 0.0 for black or 1 .0 for white, for a specified blob. 
Heading AdvancedA^ision Data Access 

Syntax GetColor(Blobs, [Index]) 

Inputs Blobs A reference to a Blobs structure. Each blob has a color value. 

Index A zero-based index into the Blobs stnicture. Default = 0, the first item. 

Returns 0.0 for black 

1.0 for white. 
Emits Nothing. 
Errors ??Invalid structure or index. 

Comments Available from the Blobs structure . For details about the returned value, see its 

documentation. 

See Also Blobs stnicture. GetArea. GetElongation. GetHoles. GetPerimeter. GetSpread . 

— = CCK3IMEX ImSight) 

A ► Data Access: GetCount function 

Description Returns a count value from a specified structure. 

Heading AdvancedA^ision Data Access 

Syntax GetCount(Struct) 

Inputs Struct A reference to a Delay structure. 

Returns Delay structure: the number of values actuaUy in the buffer. 

Emits Nothing. 

Errors Invalid stmcture or range. 

Comments For details about the returned value, see the documentation for the Delay structure. 

See Also Delay structure 



< A ^ Data Access: GetCurve function 
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Description Returns a curvature value, in counterclockwise degrees, from a structure. 

Heading Advanced/Vision Data Access 

Syntax GetCurve(Struct) 

Inputs Struct A reference to a structure containing a curve value. 

Returns Angle of curvature, in counterclockwise degrees. 

Emits Nothing. 

Errors ??lnvalid structure. 

Comments Available from the Region structure. See its documentation for details about the returned 
value. 

See Also GetAngle, GetCoL GetHieh. GetRovv. GetWide . 


^ A ► Data Access: GetDistance function 

Description Returns a distance value (the length of a line segment) from a structure. 

Heading Advanced/Vision Data Access 

Syntax GetDistance{Struct) 

Inputs Struct A reference to a Dist stuctiire . 

Returns Distance. In Pixel or World units, reflecting the source structure. 

Emits Nothing. 

Errors ??lnvalid structure. 

Comments Available from the Dist structure . See its documentation for details about the returned 
value. 

See Also Dist structure. 


^ A ► Data Access: GetEIongation function 


Description Returns an elongation value (the ratio of major to minor axes) for a specified blob. 

Heading Advanced/Vision Data Access 

Syntax GelElongation(Blobs, [Index]) 

Inputs Blobs A reference to a Blobs structui e . 

Index A zero-based index into the Blobs structure. Default = 0, the first blob. 

Returns Elongation, the ratio of the major axis to the minor axis. 

Emits None. 

Errors Invalid stmcture or index. 

Comments For details about the elongation value, see the documentation for the Blobs stmcture . 

See Also Blobs stmcture, GetArea, GetColor. GetHoles. GetPerimeter. GetSpread . 
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^ A ► Data Access: GetHigh function 

Description Returns a height value, in pixels, fix>ni a structure. 
Heading AdvancedA^ision Data Access 

Syntax GetHigh(Struct) 

Inputs Struct A reference to a structure containing a height value. 

Returns Height Always in pixels. 

Emits Nothing. 
EiTors hivalid structure. 

Comments Available fom the Cross and Region structures. See each structure's documentation for 

details about the returned values. 
See Also GetAngle. GetCol. GetOiive. GetRow. GetWide . 


^ A ► Data Access: GetHoles function 

Description Returns the number of holes (backgroxmd-colored areas) in a specified blob. 

Heading AdvancedA^ision E>ata Access 

Syntax GetHoles(Blobs, [Index]) 

Inputs Blobs A reference to a Blobs structure . 

Index A zero-based index into the Blobs structure. Default = 0, the first blob. 

Returns The number of holes, an integer. 

Emits Nothing. 
Errors ??lnvalid structure or index. 

Comments Available fiiom the Blobs stnicture . See its documentation for details about the returned 

value. 

See Also Blobs stnicture, GetArea. GctColor . GetElontation. GetPerimeter. GetSnrcad . 


^ A ► Data Access: GetMax function 
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Description Returns the maximum value from a ^)ecified stmcture. 

Heading AdvancedA/ision I>ata Access 

Syntax GetMax(Struct) 

Inputs Struct A reference to a Delay structure. 

Returns Delay stmcture: the largest value currently in the buffer. 

Emits Nothing. 

Errors Invalid structure or range. 

Comments Available from the Delay structure, which describes the returned value. 

See Also DelavLine. GetMin . 


^ A ► Data Access: GetMaxCoI function 


Description 
Heading 
Syntax 
Inputs 

Returns 


Emits 

En-ors 

Comments 

See Also 


Returns the maximum (right-most) column coordinate from a stmcture. 
AdvancedA^ision Data Access 
GetMaxCol(Struct, [Index]) 

Struct A reference to a stmcture containing an maximum column value. 

Index A zero-based index into Stmct Default = 0, the first itOTi. 

The maximum column coordinate. Always in Pixel coordinates (because the maximum 

column value in World coordinates might be a completely different point on the blob 

perimeter). 

Nothing. 

??Invalid stmcture or index. 

Available from the Blobs stmctiire . See its documentation for details about the returned 
value. 

GetCoK GetMaxRow. GetMinCoL GetMinRow. GetRow, 


^ A ► Data Access: GetMaxRow function 


Description Returns the maximum (bottom-most) row coordinate from a stmcture. 
Heading AdvancedA^ision Data Access 

Syntax GetMaxRow(Stnict, [hidex]) 

Liputs Struct A reference to a stmcture containing a maximum row value. 

Index A zero-based index into Struct Default = 0, the first item. 

Returns The bottom-most row coordinate. Always in Pixel coordinates (because the maximum 

row value in World coordinates might be a completely different point on the blob 

perimeter). 
Emits Nothing. 
Errors ???Invalid structure or index. 


SDOCID: <WO__0111445A2J_> 


Appendix I - Page 315 


I 


wo 01/11445 


PCT/USOO/22383 


Comments Available from the Blobs strucuire . See its documentation for details about the returned 

value. 

See Also GetCoK GetMaxCoL GetMinCoK GetMinRow. GetRovv . 



^ A ► Data Access: GetMean function 


Description Retums the average (arithmetical mean) fit)m a specified structure. 

Heading AdvancedA^ision Data Access 

Syntax GetMean(Struct, [??Range Start, Range End]) 

Inputs Struct A Delay structure, which stores the buffer generated by DelayLineQ- 

Retums The mean value of the buffer. 

Emits Nothing. 

Errors ??Invalid structure. 

Comments Available from the Delay structures, which describes the returned values. 

See Also Delay. EtelavLine 



^ A ► Data Access: GetMin function 


Description Retums the minimum value from a specified stmcture. 

Heading AdvancedA/^ision Data Access 

Syntax GetMin(Struct, [Range Start, Range End]) 

Inputs Struct A reference to a Delay structure. 

Retums Delay structure: the smallest value currently in the buffer. 

Emits Nothing. 

Errors Invalid structure or range. 

Comments For details about the returned value, see the documentation for the Delav structure. 

See Also DelavLine. GetMax . 



^ A ► Data Access: GetMinCol function 
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Description 
Heading 
Syntax 
Inputs 

Returns 


Emits 
En-ors 
Comments 

See Also 


Returns the minimum (left-most) column coordinate fix>m a ^)ecified structure. 
AdvancedA^ision E^ta Access 
GetMinCol(Struct, [Index]) 

Struct A reference to a structure containing an minimum column value. 

Index A zero-based index into Struct. Default = 0, the first item. 

The left-most column coordinate. Always in Pixel coordinates (because the minimum 

column value in World coordinates might be a completely different point on the blob 

perimeter). 

Nothing. 

??Invalid stmcture or index. 

Available from the Blobs structure . See its documentation for details about the returned 
value. 

GetCol. GetMaxCoK GetMaxRow, GetMinRow. GetRovy. 


iniSighf' 


^ A ► Data Access: GetMinRow function 

Description Returns the minimum (top-most) row coordinate from a structure. 
Heading AdvancedA^ision I>ata Access 

Syntax GetMinRow(StTuct, [Index]) 

Inputs Struct A reference to a stmcture containing an minimum row value. 

Index A zero-based index into Struct. Default = 0, the first item. 

Returns The top-most row coordinate. Always in Pixel coordinates (because the minimum row 

value in World coordinates might be a completely differrait point on the blob perimeter). 
Emits Nothing. 
Errors Invalid structure or index. 

Comments Available from the Blobs stmcture . See its documentation for details about the returned 

value. 

See Also GetCol. GetMaxCol. GetMaxRow. GetMinCol. GetRovv . 


^ A ► Data Access: GetNFound function 

Description Returns the number-found value from a specified structure. 

Heading AdvancedA^ision Data Access 

Syntax GetNFound(Struct) 

Inputs Struct A reference to a stmcture containing a number-found value. 

Returns The number found An integer. 

Emits Nothing, 

Errors ??lnvalid stmcture or structure index. 
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Comments 
See Also 


Available from the Blobs, Edges, and Patterns structures. See each structure's 
documentation for details about the returned value. 

Blobs structure. Edges structure. Patterns structure. Getting Started with Data Access, 


^ A ► Data Access: GetPerimeter function 


Description Returns the perimeter, in pixels, from a specified structure. 
Heading AdvancedA^ision Data Access 

Syntax GetPerimeter(Struct, [Index]) 

Inputs Struct A reference to a structure containing perimeter values. 

Index A zero-based index into Struct. Default = 0, the first item. 

Returns The perimeter value. Always in pixels, even if the source structure is in World units. 

Emits Nothing. 
Errors Invalid stmcture or index. 

Comments Available from the Blobs structme . See its documentation for details about the returned 
value. 

See Also Blobs stmcture. GetArea. GetColon GetElongation. GetHoles. GetSpread . 


^ A ► Data Access: GetPixelValue function 


Description 
Heading 
Syntax 
Inputs 


Returns 
Emits 
Errors 
Comments 
See Also 


From an Image structure, returns the grayscale value for a specified point. 
AdvancedA^ision Data Access 
GetPixel Value(Image, Fixture, Point) 


Image 
Fbrture 
— Row 
— Column 
— Theta 


Image data source, a reference to an Image structure . Default is $A$0. 
Fixture origin, defined by row, column, and angle offsets, typically to 
compensate for image-to-image variation in position, orientation, or both. 
Row and Column are ofifeets, in pixels from Hhe image origin. Theta is a 
rotation from the image row axis, ± 360° CCW. Defaults all 0 (the image 
origin). See Workinsi with Fixtures . 

Point of interest. Row and Column define the point by offsets from the 
Fixture origin, in pixels. 


Point 
— Row 
— Column 

A grayscale value, 0 through 255 
Nothing. 

??Invalid parameter. 
None. 

image stnicture. 
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V. 


^ A ► Data Access: GetRadius function 

Description Returns the radius of a specified circle or arc, in pixels. 
Heading AdvancedA/^ision Data Access 

Syntax GetRadius(Struct, [Index]) 

Inputs Struct A reference to a structure containing a radius value. 

Index A zero-based index into Struct. Default = 0, the first item. 

Returns The radius value. ??Always in pixels, even if the source stmcture is in World units.?? 

Emits Nothing. 
Errors ??Invalid structure or index. 

Comments Available fix>m the Circle and Edges structures. See each structure's documentation for 

details about the returned value. 
See Also Circle stmcture . Edaes stnicture . 


^ A ► Data Access: GetRow function 


Description 
Heading 
Syntax 
Inputs 


Returns 
Emits 
Errors 
Comments 

See Also 


Returns a row coordinate fi-om a stmcture, in Pixel or Worid units, reflecting the structure. 
AdvancedA/'ision Data Access 
GetRow(Struct, [Index!], [Index2]) 

Struct A reference to a structure containing a row value. 

Index! An zero-based index into Struct, identifying the item of interest 

Index2 Edges only. A zero-based index identifying the end point: 0 for the first end 

point or 1 for the second end point 
The row coordinate. In Pixel or World units, reflecting the source structure. 
Nothing. 

??Invalid structure or index. 

Available fiom the Blobs. Circle. Cross. Dist. Edges. Fbcture. Line. Point. Pattcms. and 
Region structures. See each structure's documentation for details about the returned value. 
GetAngle. GetCol. GetCun^e. GetHieh. GetWide. Gettin$i Started with Data Access. 


^ A ► Data Access: GetScale function 
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Description 

Heading 

Syntax 

Inputs 


Returns 

Bnits 
Errors 
Comments 

See Also 


Returns a scale value (the size of a matched instance, as a percentage of the model) from a 
specified structure. 
AdvancedA^ision Data Access 
GetScale(Struct, [Index]) 

Struct A reference to a Patterns structure. Each matched instance has a scale 

value. 

Index A zero-based index into Struct. Default = 0, the first item. 

The scale value for the specified matched instance. From XX to YY, where 100 = same 

size. 

Nothing. 

Livalid structure or index. 

Available fix)m the Patterns stmcture . See its documentation for details about the returned 
value. 

Patterns stRicture. 


A ► Data Access: GetScore function 

Description Returns a score value, 0 through 1 00, fit)m a specified structure. 
Heading AdvancedA/ision Data Access 

Syntax GetScore(Struct, [Index]) 

Inputs Struct A referaice to a structure containing a score value. 

Index A zero-based index into Struct. Default = 0, the firet item. 

Returns A score value, 0 through 100. 

Emits Nothing. 
Errors ??Invalid structure or index. 

Comments Available fix)m the Blobs. Edges, and Patterns structures. See each structure's 

docum^tation for details about the returned value. 

Edge: Black-to-white = 0 to 100; White-to-b!ack = 0 to -100. 
See Also Blobs stmcture. Edges structure. Patterns staicture . 


^ A ► Data Access: GetSDev function 
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Description Returns the standard deviation value fix>m a specified structure. 

Heading AdvancedA^ision Data Access 

Syntax GetSDev(Struct) 

Inputs Struct A Delay stiiicture. which stores the buffer generated by DelayLineO- 

Returns Standard deviation, a standard statistical measure. 

Emits Nothing. 

Errors Invalid structure. 

Coniments For details about the returned value, see the documentation for the Delay structure. 

See Also Delay stnicture. EteiavLine. 


^ A ► Data Access: GetSpread function 

Description Returns the spread value (a rough measure of compactness) for a specified blob. 

Heading AdvancedA^ision Data Access 

Syntax GetSpread(Blobs, [Index]) 

Inputs Blobs A reference to a Blobs structure. 

Index A zero-based index into Struct. Default = 0, the first item. 

Returns The spread, a rough measure of blob compactness. 

Emits Nothing. 
Errors ??lnvalid structure or index. 

Comments Available from the Blobs structure . See its documentation for details about the returned 
value. 

See Also Blobs structure. GetArea, GetColor. GetElongation. GetHoles. GetPerimeter . 


^ A ► Data Access: GetSum function 

Etescription Returns a sum value fix>m a structure. 

Heading AdvancedA^ision Data Access 

Syntax GetSum(Struct) 

Inputs Struct A reference to a Delay structure. 

Returns Delay structure: the sum of the values in the buffer. 

Emits Nothing. 

Errors Invalid stmcture or range. 

Comments For details about the returned value, see the documenation for the Delay structure. 

See Also DelayLuie . 
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Data Access: Get Value function 

Returns the number of values from a specified structure. 
AdvancedA^ision Data Access 
GetValue(Struct, Index) 

Struct A reference to a Delay structure. 

Index A zero-based index. For Delay, the time offset 

Delay structure: the value in the buffer at the specified time oflfeet 
Nothing. 

hivahd parameter- 
Available from the Delay structure. See its for details about the returned value. 
Delay structure. 

—==—=—=—= =CX3GIMEX In/Sigh^ 

^ A ► Data Access: Get Wide function 


Description Returns a width value, in pixels, fix)m a structure. 

Heading AdvancedA^ision Data Access 

Syntax GetWide(Struct) 

Inputs Struct A reference to a structure containing a width value. 

Returns Width, in pixels. 

Emits Nothing. 

Errors Invalid structure. 

Comments Available from the Cross and Region structures. See each structure's documentation for 

details about the returned values. 

See Also GetAngle. GetCoK GetCurve, GetHigli. GetRow . 



^ A ► 

Description 
Heading 
Syntax 
Inputs 

Returns 
Emits 
Errors 
Comments 
See Also 
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► In-Sight Hardware Reference 


The In-Si^t hardware includes a Vision Processor, a camera, a Control Pad, and various cables, adapters, 
and temiinal blocks for connecting the In-Sight hardware with other equipment. Ports, located on the front 
panel for easy access, include camera input, light control, discrete I/O, two serial ports, and VGA output. 
Terminals on the camera support external trigger and strobe signals. 

This section describes the In-Sight hardware in detail, discussing the following topics: 


Vision Processor Specifications 
Vision Processor Physical Layout 
T/Q Ports 

o Camera Input 

o Light Control Port 

o VGA Monitor Output 

o Serial Ports 

o Built-in Discrete I/O 

o External Discrete I/O 

o Control Pad 
Camera Reference 

o Specifications 

o Mechanical Drawing 

o Mounting Block 

o Tri tiger 

o Strobe 


Lights Reference 
o Back Light 
o Dark Field Light 
o Dome Light 
o Linear Array Light 
o On-Axis Diffuse Light 
o Ring Light 
o Spot Light 

o Strobe Control Module 
Lens Reference 

I/O Expansion Module Reference 

o Specifications 

o Connector Pinouts 

o Input and Output Schematics 
DeviccNet Gateway 
Power Supply. Connector, and LED 


For installation instructions, see fnstallins In-Si^ht , 



^ A ► Vision Processor: Specifications 

Descripdon 

In-Sight 2000, P/N 800-5714-2. 

• Industrial packaging: Standalone cast-aluminum enclosure; no moying parts such as 
fans or disk drives. 

• Four flanged Va~20 attachment points, for horizontal or yertical mounting. 

Dimensions • 1 1 .54" (width) x 5.57" (depth) x 1 .78" (height). 

For drawings, see Physical Layout , 

• Weight:??? 


Specification 
Model Number 
Enclosure 
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CPU 
Memory 


Camera 
Control Pad 
Display 


I/O 


Light Control 
Power 

Consumption 
Environmental 


Texas Instniments TMS320C6201B running at 167 MHz. 

• 4 MB of flash memory, for non-volatile job and program storage. 

• 1 6 MB SDRAM, for mn-time processing and image acquisition. 

• 1 MB VGA memory. 

Dedicated digital camera. For details, see Camera Specifications . 
Two-axis, four-button pendant controller with a 10- foot cable. 

• 640x480 VGA output through a standard 15-pin D-sub connector. 

• Color grap^cs overlay. 

• Up to 10 discrete inputs and 10 discrete outputs. Two inputs and two outputs are 
on the Vision Processor, plus eight inputs and eight ou^uts on the optional I/O 
Expansion module. 

• Two RS-232C serial ports. 

Dynamic control for one or two variable-intensity lights via one 9-pin connector. Requires 
an optional Cognex-compatible lighting ^stem. 

• 24v DC. ± 5 percent, 1 Amp. Connected by screw terminals on an intermediate, 
detachable terminal block. 

• Operating temperature: lO^'C to^S^'C. 

• Relative Humidity: 1 0 to 90 percent, non-condensing. 


^ ▲ ► 


Vision Processor: Physical Layout 


The Vision Processor (P/N 800-5714-2) contains the CPU, memory, and I/O ports. About the size of a 
paperback book, it performs all of the vision processing. It can acquire images, display them, control lights, 
and communicate with extanal devices. The following figure shows the location of its connectors and LEd' 
indicator: 



24 VDC 
Power LED 


External discrete I/O 
(26-pin connector) 

Discrete I/O 
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(8 terminal block) / y/ 
Serial 0 

Serial 1 . 

Camera Lighte VGA Control Pad 

For installation instructions, see InstaUhm In-Sfehf . 



^ A ► Vision Processor: I/O Ports 


You connect I/O devices to the Vision Processor through ports on the iront panel This section describes the 
ports. 

• Camera Port 

• Light Control Port 

• VGA Monitor Output 

• Serial Ports 

• Built-in Discrete I/O 

• External Discrete I/O 

• Discrete In Schematic 

• Discrete Out Schematic 

• Control Pad . 

For the location of the ports, see In-Si^ht Physical LavoiiL 


^ A ► Ports: Camera Input 


You connect the camera to the Vision Processor with a Category 5 shielded twisted pair (STP) cable 
(P/N XXX- YYY or equivalent). The cable, terminated with standard, 8-pin RJ-45 connectors, carries video 
and sync from the camera to the Vision Processor and power and serial communications from the Vision 
Processor to the camera. The RJ-45 pin numbering and pin assignments aie: 

2 (left-most) 
7 (right-most) 

Left to right: 2, 1, 3, 5, 4, 6, 8, 7 
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Pin 


Signal Name 


Pin 


Signal Name 


7 


1 

3 
5 


Clock - 

Camera RX data 
Power: 4-5 or -i- 12 DC, 
fused at 1 Amp 
Video/Sync — 


8 


2 
4 
6 


Video/Sync + 


Clock + 

Camera TX data 
Ground 


NOTES • The camera port and the two serial ports use identical RJ-45 connectors. Make sure you 


connect each device to the appropriate conne';tor. Connecting the camera to a serial port 
might damage the Vision Processor, camera, or both. 

• In-Sight's camera interface does not support off-the-shelf cameras. Do not connect 
cameras other than In-Sight*s dedicated camera. Connecting an incompatible camera might 
damage the Vision Processor, camera, or both. 

• The Category 5 specification is being revised to include a higher-performance variation 
called Category 7. If you are using a non-Cognex camera cable, obtain a Category 7 cable 
instead of a Category 5 cable if possible. The video signal benefits fix>m the improved 
shielding and other features of the Category 7 standard. 


The Vision Processor can dynamically control one or two Cognex-compatible variable-intensity lights. To 
save space on the fi-ont panel, the LIGHTS port carries the signals for both lights on one 9-pin connector. 
Cognex lights therefore inchide a Y-adapter cable that separates the signals for the two lights. One leg of the 
Y terminates in a 9-pin DIN connector that plugs into the Vision Processor. The other legs terminate in either 
6-pin RJ- 1 1 or 7-pin DIN connectors that plug into the lights. This topic describes the light control signals 
and connectors. 

Each light has one or two banks of LEDs, which are independendy controlled through 8-bit values. For both 
banks, 0 turns the bank fiilly OFF; 255 turns it fiilly ON; and intermediate values yield intermediate light 
levels. For details about setting the hght levels, see Controllins Variable Lights . 

To maintain compatibility with existing Cognex hardware, the lighting control signals are equivalent to those 
used in previous Cognex vision boards. 

N01>Z Certain Cognex strobe lights can obtain power through the hght control port. To use a variable- 
intensity light and a strobe at the same time, you must supply external power to the strobe. 

9-pin DIN Pin Numbering and Pin Assignments 
The LIGHTS port on the Vision Processor 


For installation instructions, see Installing the Lens and Camera , 


CCX3I\IEX Insight/ 


^ A ► Ports: Light Control 
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Pin Signal Name 

1 Light 0, Bank 0 

3 Light 0, Bank I 

5 Light 1, Bank 0 

7 Light 1, Bank 1 

9 TBD 


Pin Signal Name 

2 + 12v DC, light 0 
4 -M2v DC, light 0 
6 + 12v DC, light 1 
8 + 12v DC, light 1 


Adapter Cables 

To sqjarate the two lights, Cognex offers Y adapter cables to go along with its lights. Different lights have 
different connectors, so you must use the cable that fits your lights. One leg of the Y always has a 9-pin DIN 
connector to phig into the Vision Processor; the other legs terminate in 6-pin RJ- 1 1 or 7-pin mini-DIN 
connectors, 

7-Pin Mini-DIN Pin Numbering and Pin Assignments (P/N XXX-YYY) 


Pin Signal Name Pin Signal Name 

1 ?? 2 ?? 

3 ?? 4 ?? 

5 ?? 6 ?? 

7 ?? 

RJ-l 1 Pin Numbering and Pin Assignments (P/N XXX-YYY) 


Pin Signal Name Pin Signal Name 

1 ?? 2 ?? 

3 ?? 4 ?? 

5 ?? 6 ?? 
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For installation instructions, see Cowiecting Lights . 



^ A ► Ports: VGA Output 

In-Sight's 640x480 VGA output conforms to the VGA standard. You can connect any VGA monitor or 
flat-pane) LCD display that supports the 60 Hz refresh rate. Pin numbering and pin assignments for the 
1 5-pin D-sub connector are as follows: 


5-^ 



^1 




(§) (§)©(< 





10 — 

\ @(§)(Q>@ 


f—S 















Pin 

Signal Name 

Pin 

Signal Name 

Pin 

Signal Nan 

1 

Red 

2 

Green 

3 

Blue 

4 

ID 2 (not used) 

5 

Ground 

6 

Analog Ground 

7 

Analog Ground 

8 

Analog Ground 

9 

Key (not used) 

10 

Ground 

11 

ID 0 (not used) 

12 

ID 1 (not used) 

13 

HSYNC 

14 

VSYNC 

15 

ID 3 (not used) 


For installation instructions, see Connecting a VGA Monitor . 



A ► Ports: Serial Ports 

In-Sight provides two high-speed (115 kbaud) asynchronous serial ports for local communication with a PC 
or other devices. Serial port 0 and serial port 1 both confomi to the RS-232 standard, except that they use 
an RJ-45 connector instead of a DB-9 or DB-25 connector. You can use a Category 5 cable for serial 
communications, converting to DB-9 or DB-25 through an adapter if necessary. To accommodate DB-9 
devices, In-Si^t ships with an adapter cable (P/N XXX-YYY) with an RJ-45 connector on one end and a 
DB-9 connector on the other.?? 

The RJ-45 pin numbering and pin assignments are: 
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2 (teft-most) 
7 (right-mosf) 

Left to right: 2, 1, 3, 5, 4, 6, 8, 7 


Pin Signal Name Pin Signal Name 

1 Ring detect 2 RXdata 

3 TXdata 4 DTR 

5 Ground 6 DSR 

7 RTS 8 CTS 

NOTE The camera port and the two serial ports use identical RJ-45 connectors. Make sure you connect 
each device to the appropriate connector. Connecting a serial device to the camera port might 
damage the Vision Processor, Serial Device, or both. 

For installation instructions, see Connecting! a Serial Device . 


^ A ► Ports: Built-in Discrete I/O 

In-Sight offers a total often discrete inputs and ten discrete outputs for general-purpose use. Two inputs and 
two outputs are built in to the Vision Processor, which provides optical isolation. The remaining inputs and 
outputs require the external I/O Expansion Module, connected through a 26-pin high-density D-sub 
connector. Each discrete I/O signal is electrically independent fiom the others. 

??By default, polarity is active-high, so the transition from Ov to 12v DC indicates ON. You can invert the 
polarity (active-low) through the In-Sight software as described in Setting up Discrete Input and Setting 
wy Discrete Output . 

For the built-in inputs and outputs, you connect twisted pair or other wiring through a detachable S-terminal 
block (Cognex P/N XXX- YYY, or Phoenix Connector #1 8036331 Its pin numbering and pin assignments 
are as follows; 



• / I I I — v-v 

IN 9* / 0UT8+ [ OUT 9+ / 
IN 9- OUTS- 0UT9- 
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Pin Signal Name Pin Signal Name 

1 IN8+ 2 IN8- 

3 IN9+ 4 IN9- 

5 OUT 8+ 6 OUT8- 

7 OUT 9+ 8 OUT9- 

For circuit diagrams, see Discrete In Schematic and Discrete Out Scbentatic . 



^ A ► Ports: External Discrete I/O 

In addition to the two discrete inputs and two discrete ou^uts built into the Vision Processor, In-Sight offers 
eight external inputs and eight external outputs (a total of ten each). External discrete I/O requires connecting 
an I/O Exp ansion Module through a 26-pin high-density E>-sub connector. You then connect twisted pair or 
other wiring to the I/O Module. 

Each discrete I/O signal is electrically independent from the others. The Vision Processor provides optical 
isolation for the built-in mp\xts and outputs, and the I/O Module provides optical isolation for the external 
inputs and outputs. The pin numbering and pin assignm^ts for the 26-pin connector are as follows: 



Pin Signal Name 

Pin Signal Name 

Pin Signal Name 

Pin Signal Name 

1 INO 

2 IN 1 

3 IN2 

4 IN3 

5 IN 4 

6 INS 

7 IN6 

8 IN7 

9 OUTO 

10 OUT 1 

11 OUT 2 

12 OUT 3 

13 OUT 4 

14 OUTS 

15 OUT 6 

16 OUT 7 

17 Power, +5 V DC, 

18 Power, +5v DC, 

19 Ground 

20 Ground 

fused at 0.5 A. 

fused at 0.5 A. 



21 Ground 

22 Ground 

23 Ground 

24 Ground 

25 Not connected. 

26 Not connected. 




NO TE This connector is dedicated to the VO Expansion Module. The signals are NOT opto-isolated. To 
supplement the built-in inputs and outputs, you must use the I/O module. 

Polarity is software selectable as described in Setting un Discrete Itmut and Setting up Discrete Output . 
For circuit diagrams, see Discrete In Schematic and Discrete Out Schematic , 
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^ A ► Ports: Discrete In Schematic 

NOTE This schematic applies to the built-in discrete inputs, numbere 8 and 9. For the external discrete 
inputs, see I/O Expansion Module Jnnut and Output Schematics . 


GPlS- 


V 


D8 


U31-A 


C52 


^ A ► Ports: Discrete Out Schematic 


NOTK This schematic applies to the built-in discrete outputs, numbers 8 and 9. For the external discrete 
outputs, see see f/O Expansion Module Schematics . 
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GPOS- 


— =— — — COCSISiEX Insight) 

^ A ► Ports: Control Pad 

In-Sight requires a dedicated Control Pad for user iiput The pin numbering and pin assignments for its DB- 


1 5 connector are: 






ff^@(§)(o)<o)<s 


-1 
-6 



10 — 


hf 







11 



Pin 

Signal Name 

Pin 

Signal Name 

Pin 

Signal Name 

1 

Power, +5v DC 

2 

Button 1 

3 

Analog 0 (cursor) 

4 

Ground 

5 

Ground 

6 

Analog 1 (cursor) 

7 

Button 2 

8 

Not connected 

9 

Power, +5v DC 

10 

Button 3 

11 

Analog 2 (cursor) 

12 

Ground 

13 

Analog 3 (cursor) 

14 

Button 4 

15 

Not connected 


This connector is electrically compatable with most analog 2-axis, 4-button PC game pad devices. Disable 
"turbo" mode, which may cause enatic behavior. For installation details, see Connecting the Cont rol Pad, 
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CC3GIMEX 



A ► Camera: Hardware Reference 


The In-Sight camera (P/N 1 18-0034) sends a video signal to the Vision Processor over a Category 5 
shielded twisted pair (STP) cable temiinated with standard RJ-45 connectors (P/N XXX- YYY or 
equivalent). The maximum cable length is 25 feet. The puipose-built camera is matched to the Vision 
Processor, which sipplies all of its power and signals. Off-the-shelf cameras are incompatible. Multiple 
cameras are unsupported. 


The external trigger and strobe lines connect to the camera, not to the Vision Processor. You attach twisted 
pair or other suitable wiring through an intermediate, detachable temrunal block, which bundles the wires 
together for easy assembly and reassembly. 

NOTE The Category 5 specification is being extended to include a higher-performance variation called 
Category 7. If you are using a non-Cognex camera cable, obtain a Category 7 cable instead of a 
Category 5 cable if possible. The video signal benefits fiom the improved shielding and other 
features of the Category 7 standard. 

For the RJ-45 pin numbering and pin assignments, see Camera Input Port, For installation instructions, see 
Installing the Lens, Camera, and Cable , 



^ Trigger + 
■ — Trigger - 


Strobe + 
Strobe - 


RJ-45 connector 
(video out) 


COCSIMEX 



^ A ► Camera: Specifications 
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Specification Description 
Part Number 118-0034 

Acquisition Rapid reset, progressive scan, fiiU-finame integration. 
Resolution • Up to 640 x 480 image size, 8-bit pixel resolutioa 

• ??C)ptional half-resolution (320 x 480) acquisition, for faster acquire and processing 
speeds.?? 

Sensor • One-third inch CCD. 

• 307;200 pixels (a 640 X 480 image). 

• Square pixels, 7.4 micrometers x 7.4 micrometers. 

• Shutter speed: 64 ^iSec through 33 milliseconds. 

Lens • C mount lens. 

• Manual iris control. 

• Focal lengths available from Cognex are: 

6mm(P/N 1 14-0049); 8.5 mm (P/N 1 14-0039); 12.5 mm (P/N 1 14-0004); 16 mm 
(P/N 1 14-0018); 25 mm (P/N 1 14-0001); 35 mm (P/N 1 14-0041); 50 mm 
(P/N 114-0040); 

• Extension tube set (P/N 1 1 4-0009). 

Cable Category 7 (a higher-performance variation of the Category 5 standard.) Maximum length, 

25 feet. 

Gain Gain and offset control through the In-Sight software. 

Mechanical • Aluminum housing. 

• Dimensions: ?1 .375" (width) x 1 .375" (height) x 3.25" (depth) (excludes lens and lens 

mount)? 

• ??Non-conductive plastic mounting block, with %-20 threaded attachment points 
(P/N XXX-YYYY). 

• Weight: ???? (excludes lens). 

Environmental • Operating: Temperanire: 1 0 to 45° C. Humidity: 1 0 to 90 percent non-condensing. 

• Storage: Temperature: -40 to 65^ C. Humidity: 10 to 90 percent non-condensing. 

Power ??+5v DC, supplied from the Vision Processor. 

For the DB-45 pin numbering and pin assignments, see Camera Inmit Port, For installation instructions, see 

Insmnin^ the Lens. Camera, and Cable , 


COGMEX ImSigh^ 

^ A ► Camera: Physical Layout 

The Vision Processor contains the image sensor. ??Need a mechanical drawing of the camera?? 
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For installation instructions, see Instatlim^ Fn-Siaht , 



^ A ► Camera: Mounting Block 

In-Sight includes a non-conductive, plastic mounting block (P/N XXX-YYYY) for the camera. It has Va-IO 
threaded attachment points. 


For installation instructions, see InsTalUnii fn-Siehl . 



^ A ► Camera: Trigger Signal 

The In-Sight camera offers optically isolated screw tenninal irputs, ??labled TRIGGER??, for an external 
asynchronous trigger signal. To acquire an image, apply XXXv to YYYv DC to the terminals. The active 
sense (or polarity) of this input is software configurable, as described in ???. 

You connect the trigger aiKl strobe wires through a detachable terminal block (Cognex P/N XXX- YYY, or 
Phoenix Connector #1 803594). Bundling the wires through the terminal block makes it easy to connect and 
reconnect equipment For installation details, see Installing an External Trigger . 
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J3 

1803293 

— L!_TQiG±- 


R31 IK 
R23 1K 


R24 IK 


2 TRIO 



U14 
BAV99 


3 STROBE^ 


4 STROBE- 


P21 350 


P22 330 
R30 330 

^ — WV-«- 


8!: 


>a4C33 


+ 3.3V 
<p U17 

PC357Nn 


R25 100 


^TTTB^ ^ 'WV — * 



^ A ► Camera: Strobe Signal 

The In-Sight camera offers optically isolated screw terminal inputs, ??labled STROBE??, to activate an 
external strobe light. When the camera is ready to integrate light, it ?does what?. ??Piilse width is the 
duration of two lines, 128 microseconds total, during which the optocoiiqpler switch is closed. SW issue- 
HW has programmable polarity and pulse width??? 

You connect the strobe and trigger wires through a detachable teraiinal block (Cognex P/N XXX- YYY, or 
Phoenix Connector #1 803594). Bundling the wires through the terminal block makes it easy to connect and 
reconnect equipment. For installation details, see Instatlins a Strobe Liaht , 
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NOTE If you are using a Cognex strobe powered through the light control port, you must set the Light 
Power value to 255. ??Confirm final behavior through RR?? 


J3 

1803293 

1 TRIG* 


P31 IK 

VW— ^ 

R23 1K 
R24 1K 


2 TRIQ- 


3 STROBE... 


4 STROBE 


P21 330 


R22 330 

AAAr- 

R30 330 

AAAr- 


U14 
BAV99 



U5 

BZXS4C33 


H3.3V 
? Lrl7 

PC357N71 


R25 1 00 


^TPB" a-' WA/ ^ 



^ A ► Lights Reference 

Cognex offers a selection of lights for a variety of imaging requirements. All feature variable-intensity or 
strobed operation. (Both features are built into the lights, but only one mode is available at a time because 
the cable for variable-intensity operation differs from the cable for strobed operation.) To obtain Cognex 
lights, light cables, or other hghting accessories, call Cognex at 877-855-8705. 
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Light 
Back Light 

Park Field Light 

Dome Light 

Linear Array 
On-Axis Diffuse 

Ring Light 
Spot Light 

Accessory 
Strobe Control 
Module 
??Strobe Cable 
XXX Cable 


Description 

Intense back light illumination over a four-inch square area 
in a low-profile package. 

Low-angle, radial dark£eld illumination, for areas up to 
four inches in diameter. 

Extremely even, difiiise illumination across a 3.3-inch 
(8S-mm) diameter. 

Low-angle illumination over a long, narrow area. 
On-axis diffuse illumination within a 2- by 2-inch (50- by 
50 mm) area. 

Relatively diffuse, off-axis illumination over small areas. 
High-intensity off-axis illumination over small areas. 

Description 
Interface box required for strobed operation. 

XXX-pin to YYY-pin required for strobed operation. 
XXX to YYY cable, required for variable-intensity 
operation. 


Part Number 

XXX-YYY 

XXX-YYY 

XXX-YYY 

XXX-YYY 
XXX-YYY 

XXX-YYY 
XXX-YYY 

Part Number 
XXX-YYY 

XXX-YYY 
XXX-YYY 


For infonnation about applications for lights, see Ushtins Guidelines . 

= — = = COGIMEX Insight) 

^ A ► Lights: Back Light 

The Cognex Back Light (P/N XXX-YYY) offers intense back light illumination over a four-inch square area 
in a low-profile package. 



• Variable-intensity or strobed operation; power supplied by the 
Vision Processor. 

• Solid-state illumination for stable, calibration-free operation. 

• Spectral characteristics: 660 ± 25 nm (red). 

• Projected light distribution: db 6% over the illuminated area. 

• Heavy-duty housing with integrated mounting ears, 

• Operating temperature range: 0 to 65** C. 

• LED life: 100,000 hours. 

• Supphed Y-adaptor cable (9-pin to 7-pin) is P/N XXX-YYY. 
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Dimensions in millimeters (inches) 


128.5 
[5.06) 



156.5 


~1 
30.7 
(1.21) 


101.6 
(4.00) 


17.3 
(.68) 


101.6 
(4.00) 


^ A ► Lights: Dark Field Light 


The Cognex Dark Field Light (P/N XXX- YYY) offers very low-angle, radial daricfield ilJumination, for areas 
up to four inches in diameter. 
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• Variable-intensity or strobed operation; power supplied by the 
Vision Processor. 

• Spectral characteristics: 660 ± 25 nm (red). 

• Operating temperature range: 0 to 65° C. 

• LED life: 100,000 hours. 

• Supplied Y-adaptor cable (9-pin to 7-pin) is P/N XXX- YYY. 


M4 
JF^LCS 


101 .6 
(4.001 



Dimensions in millimelers (inchr 


14.0 
(.55)" 




^ A ► Lights: Dome Light 

The Cognex Dome Light (P/N XXX-YYY) offers extremely even difRise illumination across a 3.3 inch (85 
nun) diameter. Suitable for rapidly moving, highly reflective, specular objects. 

• Variable-intensity or strobed operation; power supplied by the 
Vision Processor. 

• Spectral characteristics: 660 ± 25 nm (red). 

• Projected light distribution: ± 3% edge-to-edge over a 3.3-inch 
(85 mm) diameter area. 

• Operating temperature range: 0 to 65** C. 

• LED hfe: 100,000 hours. 

• Supplied Y-adaptor cable (9-pin to 7-pin) is P/N XXX-YYY. 
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^ A ► Lights: Linear Array Light 

The Cognex Linear Airay (P/N XXX- YYY) offers low-angle illumination over a long, nanrow area. 



• Variable-intensity or strobed operation; power supplied by the 
Vision Processor. 

• Spectral characteristics: 660 ± 25 nm (red). 

• Projected light distribution: ± 3% edge-to-edge in the longitudinal 
direction. Controlled fall-off in the transverse direction. 

• Operating ten^rature range: 0 to 65° C. 

• LED life: 100,000 hours. 

• Supplied Y-adaptor cable (9-pin to 7-pin) is P/N XXX- YYY. 


For applications requiring even illumination, you can install two Linear Array lights facing each other. 
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Dimensions in millimeters (inches) 



^ A ► Lights: On- Axis Diffuse Light 

The Cognex On- Axis Diffuse Light (P/N XXX- YYY) provides on-axis diffuse illumination within a 2-inch 
by 2-inch area. 

• Variable-intensity or strobed operation; power supplied by the 
Vision Processor. 

• Spectral characteristics: 660 ± 25 nm (red). 

• IMbmi iUumination (± 8%) over its 2 x 2 inch (50 x 50 mm) 
aperture. 

• Conrq5letely solid state, for low maintenance. 

• Operating Temperature Range: 0 to 65** C. 

• Projected Light EHstribution:^ 10% edge-to-edge. 

• LED life: 100,000 hours. 

• Supplied Y-adaptor cable (9-pin to 7-pin) is P/N XXX- YYY. 



Dimensions in millimeters (inches) 



12 7 
(.50) 


(4.60) 


25. i 
(100) 


O 
O 


O 


53.8 
(2.12) 


rvi6 

'6 PLCS 


25.4 I 
(LOO) 
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^ A ► Lights: Ring Light 

The Cognex Ring Light (P/N XXX- YYY) offers relatively diffuse, off"-axis illumination over small areas. 

• Variable-intensity or strobed operation; power supplied by the 
Vision Processor. 

• Spectral characteristics: 660 ± 25 nm (red). 

• Illumination free fix)m specular reflection over a 1 .5 inch (38 mm) 
diameter, encompasing a 1 .06 inch (27 mm) square field-of- 
view. 

• Light-head to illumnation-plane distance of two to four inches (5 1 
to 102 mm). 

• Heavy-duty housing with integrated mounting ears. 

• Operating Temperature Range: 0 to 65*' C. 

• Projected Light Distribution: ±10 percent edge-to-edge. 

• LED life: 100,000 hours. 

• Supphed Y-adaptor cable (9-pin to 7-pin) is P/N XXX- YYY, 
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^ A ► Lights: Spot Light 

The Cognex Spot Light (P/N XXX- YYY) offers high-intensity off-axis ilhimination over smaD areas. 



^ • Variable-intensity or strobed operation; power supplied by the 

Vision Processor. 

• Spectral characteristics: 660 ± 25 nm (red). 

• Projected light distribution: ± 1 0 percent edge-to-edge. 

• Operating temperature range: 0 to 65^* C. 

• LED life: 100,000 hours. 

• Supplied Y-adaptor cable (9-pin to 7-pin) is P/N XXX- YYY. 


To provide even illumination on two sides of a part, you can install two spot lights, one on each side of the 
illumnated area. 



^ A ► Lights: Strobe Control Module 

To operate the Cognex hghts in strobe mode, you must install a strobe control module in between the Vision 
Processor and the light. Design is TBD. Specifications are: 

Specification Description 
Perforniance • Flash Repetition Rate (maximum): 33 pulses/sec 

• Output Pulse Width: 10 iSec to 290 iSec in 10 iSec increments, controlled by 
switch input 

• Output Consistency: ± 2.5% or better 

• MTBF (minimum): 10^ Flashes 
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Electrical • Input Power 12v DC at 250 ma ( 1 ) 

• Trigger Signal: CMOS/TTL compatible, positive edge trigger 

• Turn-on Delay (maximum): 2 iSec 

• Output Current: 4 channels at 1 A per channel 

• Trigger Connection: Phoenix style terminal strip to match In-Sight camera terminal 
strip 

• Power Connection: 7-pin male DIN connector 

• Light Coruiector 7-pin female DIN connector 

• Power Cable: Same as Light Cable 

• Light Cable: 7-pin female DIN to 7-pin male DIN, Length TBD 

• In-Sight Light Control Cable Adapter 9-pin mini-DIN to two 7-pin female DIN 
connectors in a mountable housing 

Mechanical • Mounting: Flanges on two edges of enclosure with holes capable of accepting Va-IO 
minimum 

Environmental • Markings: UL, CSA, CE 

• Operating Temperature Range: C to eO'^C 

• Storage TemperaUu-e: -40°C to 90°C 

• Operating Humidity Range: 0 to 90% (non-condensing) 


^ A ► Lens Reference 

The In-Sight camera requires a C-mount lens. Focal lengths available fix)m Cognex include: 

• 6.0nim(P/N 114-0049) 

• 8.5mm(P/N 114-0039) 

• 12.5mm(P/N 114-0004) 

• 16 mm (P/N 114-0018) 

• 25 mm (P/N 114-0001) 

• 35 mm (P/N 114-0041) 

• 50 mm (P/N 114-0040). 

NOTE When using a CS-mount lens, add a 5 mm extension tube to compensate for the optical differences 
between C-mount and CS-mount systems. When calculating field-of-view, be sure to allow for the 
extension tube. 


An extension tube set containing 0.5, 1.0, 10, 20, and 40 mm extension tubes is available as P/N 1 14-0009. 
To obtain lenses or extension tubes contact Cognex at 877-855-8705. For infonnation about selecting a 
lens and extension tube, see Selecting a Lens . 
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^ A ► I/O Expansion Module Reference 

The Vision Processor offers two built-in discrete inputs and two built-in discrete outputs. To increase the 
number of inputs and outputs, you can connect an optional I/O Expansion Module (P/N 800-57 1 2- 1 ) to the 
Vision Processor. The I/O Module, configured for standard #3 DIN rail mounting, offers eight ir^uts and 
eight outputs— yielding a total often in all. To d>tain bi-Sight options and accessories, call Cognex at 
877-855-8705. 



For each input and output, the I/O Expansion Module has an LED that indicates the state of the signal 
In-Sight supplies the power to the I/O Module; no external power is required The following figure shows 
methods of connecting input and ou5>ut signals to the re^>ective terminal blocks: 
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User-Supple:! | iof" 



^ A ► I/O Expansion Module: Specifications 


Feature 
Mechanical 


Description 

E>imensions: 

o 4.688** (width) X 2.375" (height) X 3.25" (depth) 

o 1 1 .91 cm (width) X 6.03 cm (height) X 8.26 cm (depth) 

DIN rail mountable 

Weight: TTT? 


5vto 12vDC 


+5v DC, si4)p]ied from the Vision Processor. 
15 mA (sink or source). 


Operating Voltage 
(Field Side) 
Power 

Maximum Output 
Current 

ON State Voltage Drop 0.8 v DC @ 10 mA, 2.6v DC @ 15 mA 
OFF State Leakage 1 00 ^ A; maximum @ 1 5v DC 
Current 

Output Delay • ON: 6 microseconds 

• OFF: 130 microseconds @ 5 mA; 95 microseconds ( 
microseconds @ 1 5 mA. 


! 10 mA; 85 


Input Resistance 
Input State Current 


1000 Ohms. 

• ON: 3.5 to 15 mA. 

• OFF: 500 uA. 


Input Delay 


Field Wiring Size 
Terminal block Torque 
Cable 

Environmental 


ON: 30 milliseconds ^ 
OFF: 45 milliseconds ( 


3.5 mA; 8 milliseconds @ 15 mA. 
g 3.5 mA; 80 milliseconds @ 15 mA. 


26 to 12 AWG. 

Maximum 0.8 (7) N-M (in-lbO 

7-foot. Supplied. 

• Operating Temperature: 0 to 50° C 

• Storage Temperature: -20 to 85** C 

• Relative Humidity: 5 to 95 percent non-condensing. 
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For the DB-45 pin numbering and pin assignments, see Camera Input Port . For installation instructions, see 
Instailinf! the Lens. Camera, and Cable . 



^ A ► I/O Expansion Module: Pinouts 

The I/O Expansion Module has a 26-pin connector, an S-terminal input block, and an 8-tenninal output 
block. This topic describes the terminal blocks. For the 26-pin connector, se^ External Discrete I/O . 


Input Terminal Block 



Pin Signal Name 

Pin Signal Name 

Pin Signal Name 

Pin Signal Name 

1 INO + 

2 INO- 

3 

IN I + 

4 IN 1 - 

(LED Anode) 

(LED Cathode) 


(LED Anode) 

(LED Cathode) 

5 IN2 + 

6 IN2- 

7 

IN3 + 

8 IN3- 

(LED Anode) 

(LED Cathode) 


(LED Anode) 

(LED Cathode) 

9 IN4 + 

10 IN 4- 

11 

IN5-f 

12 IN 5 - 

(LED Anode) 

(LED Cathode) 


(LED Anode) 

(LED Cathode) 

13 IN 6 + 

14 IN 6- 

15 

IN7 + 

16 IN 7- 

(LED Anode) 

(LED Cathode) 


(LED Anode) 

(LED Cathode) 


Output Terminal Block 
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Pin Signal Name Pin Signal Name Pin Signal Name Pin Signal Name 


1 OUT0+ 

2 OUTO- 

3 OUT 1 + 

4 OUT 1 - 

(Collector) 

(Emitter) 

(Collector) 

(Emitter) 

5 OUT2+ 

6 OUT2- 

7 OUT3-f 

8 OUT3- 

(Collector) 

(Emitter) 

(Collector) 

(Emitter) 

9 OUT4+ 

10 OUT4- 

11 OUT 5 + 

12 OUT5- 

(Collector) 

(Emitter) 

(Collector) 

(Emitter) 

13 OUT 6 + 

14 OUT6- 

15 OUT 7 + 

16 OUT 7 - 

(Collector) 

(Emitter) 

(Collector) 

(Emitter) 


Polarity is software selectable as described in Selnns^ up Discrete Input and Setting my Discrete Output , 
For circuit diagrams, see Discrete In Schematic and Discrete Out Schematic , 


^ A ► I/O Expansion Module: Schematics 

NOTE These schematics applyto the external discrete inputs and outputs. For the built-in discrete I/O, see 
Discrete In Schematic and Discrete Out Schematic , 

Typical Input Schematic 



^5V 



Typical Output Schematic 
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To: Powerup 
Reset Sigfial 


^ A ► DeviceNet Gateway 


??Topic describes the devicenet gateway. 


^ A ► Power Supply Reference 


In-Sight requires a 24v DC power supply connected to the Vision Processor through screw terminals on a 
detachable terminal block. Some In-Sight configurations include an AC adapter (Cognex P/N XXX-YYY 
or EOS P/N ZVC30-24-D) that converts lOOv to 240v AC (50 to 60 Hz) line current to 24v DC. Other 
configurations assume you already have a 24v DC power source. To install the power siq?ply, see 
Connecting the Power Supply . 

Power-related features and specifications include: 

Feature Descripeion 
Voltage 24-volt DC, ± 5 percent. 

Consuinption 1 .0 Amp (max). 

Fuse Polyswitch-type. If tripped, resets automatically at power OFF. Not user replaceable. 

Terminal Detachable two-terminal connector block, Cognex P/N XXX-YYY, or PhoenLx Connector 
Block #1 803578. Wiring size is 22 to 14 AWG. 


Ground 24 VDC 
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LED indicator Located on the left-side of the Vision Processor's front panel. Lit when power is present, 
dark when power is absent or after tripping the fuse. 

The AC input on the AC Adaptor is a C8 lEC 320 connector. Plug types vary internationally: 

Plug Description 
North AmericanEOS P/N 5 1 1 0-00 1 -004 or equivalent 
European EOS P/N 5 1 1 0-00 1 -0 1 2 or equivalent 
Japanese EOS P/N 5 1 1 0-00 1 -005 or eqdvalent 

AustraU an EOS P/N 5 1 1 0-00 1 -006 or equivalent 
United KingdomEOS P/N 5 11 0-00 1-008 or equivalent 
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^ A ► Release Note 

This release note describes the In-Sight Alpha Demo release, prepared for the Cognex 1999 sales meeting. 
It discusses these topics: 

• About This Release 

• Fixed Pioblems 

• Known Problems . 

NOTE This version of the release note reflects the best information available when the help system was 
built. For a later version, check tfie RELNOTE.TXT file on the installation disk. 


NOTE THIS IS AN EARLY ROUGH DRAFT. It is incomplete, inaccurate, and unneviewed. In its current 
state, it should give you the flavor of the forthcoming document, but you can rely on it only 
approximately. 



^ A ► Release Note: About This Release 

This is a preliminary release and subject to change. Special features include: 

• This version can acquire an image only if running on a MS Windows NT system that has a Cognex 
8100 board and the OMI 2.1 driver. To enable this feature, remove the -nohardware* command-line 
option. Otherwise, it loads the In-Sigh^vp^image.bmp file provided on the installation disk. You can 
overwrite this file with a different acuWin/OMI-compatible bitmap. 

• By defeult, this version starts in full-screen mode. You cannot shut down In-Sight fix)m full-screen 
mode. To toggle between full-screen and windowed modes, press F4. To avoid starting the software 
in full-screen mode, add the -windowed' command-line option. 

• To suppress the animated splash screen, add the -nosplash* option. 

• The In-Sight online documentation is a conpiled HtmlHelp (.chm) file and requires MS Internet 
Explorer 4.0 or higher. To recognize a .chm file, many versions of IE 4.0 require additional software 
installed by a program called hhupd.exe, supplied on the second In-Sight installation disk. If you have 
problems displaying the In-Sightchm file, contact Steve Pendleton in the Portland office (503-620- 
6601 orspendlet@cognex.com). 



A ► Release Note: Fixed Problems 

No current list. 
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— — = ——=^—= — COGMEX Insight/ 

^ A ► Release Note: Known Problems 

NCTI E Please report any bugs, problems, or concerns about the hardware, software, or 
documentation to Tom Baker at the Portland office by internal emaO* 

The Alpha Demo version of In-Sight is known to have the following problems: 

• No current list. 
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^ A ^ Glossary 


absolute A cell reference that does not change when copied to a new location. For example, 
reference if cell Bl contains a formula with an absolute reference to cell $A$i, and Bl is 
copied to CI, then the new formula in CI still refers to $A$1. In formulas, a $ 
symbol indicates an absolute reference. When building a formula, you can create 
an absolute reference from the Formula Builder dialog or from the Enter menu . 
Contrast with mixed reference and relative reference. 

acceptance A minimum acceptable score. A feature extraction algorithm can immediately 
threshold reject any feature scoring below this value as an unambiguous failure. 

100 I 

l-Ycs 


o 
o 


Contus 


Accept 


'Maybe 


-No 


A confusion threshold , in contrast, defines certainty. 

acquisition The process of obtaining an image from the camera and writing it to the Vision 

Processor. In-Sight offers the several methods for triggering an acquisition. After 
acquiring an image, In-Sight updates the worksheet by evaluating the formulas in 
the current job. 


advanced 
dialog 



bin 


blob 


In histogram analysis , one of the values in a histogram array. Preparing a 
histogram involves counting the number of occurrences of each grayscale value 
and placing each total in a bin. An 8-bit image has 256 grayscale values, so its 
histogram has 256 bins. The bin number equals the grayscale value totaled there. 
Bin 0, for instance, holds the count of pixels at grayscale 0; bin 1 holds the count 
at grayscale 1; and so on. 

A connected patch of pixels, where every grayscale value is on one side of a 
specified threshold value. 
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blob A feature extraction method, also called connectivity analysis or connected 

analysis components analysis, for finding and classifying blobs in an image. Often used to 

find image features that fit generalized criteria such as size or color. See Bfob 

Ana/ vsts. 

bothat fllterAn image processing filter that keeps dark features smaller than a specified height 
and width. See Image Process/n a. 

brightfleld A lighting technique that makes scratches, scribe marks, and other diffuse features 
appear dark on a bright background by reflecting light from a flat, spectral surface 
into the lens. 


Uc|ht 


Lens 



calibration 


Rough surface 
(dark feature) 

Smooth surface 
(bright background) 


Contrast with darkfield lighting . For details, see Uohtino Technfoues . 

A coordinate transformation obtained from a set of points with known locations in 
the real world and in the image. The transformation obtained from a few known 
points can then convert any point in one coordinate system to the other coordinate 
system through interpolation. Vision applications typically use calibration to map 
points and distances between image and real-world locations in either direction. 

The image space, expressed in row-and-column values, is called the Pixel 
coordinate system . The physical space, expressed in inches, millimeters, or some 
other linear unit, is called the World coordinate svstem . See Coord/nate 
Transforms . 


calibration 
plate 


camera 


A structure used to establish a calibrated transformation, 
is a grid with a known spacing: 

Physical calibration plate Acquired image of 
(10 mm dot pitch) calibration plate 


A typical calibration plate 



35l±H±tt: 


Image point 

(7^ pixels, 8.0 pixels) 

I t I , 

[Transformation I 

ri 

Physical poinrt 
(291 mm, 333 mm) 


Image coorcftnate system 

After obtaining an appropriate calibration plate, you acquire an image of it using 
the intended optical and physical setup. You can then identify a set of points in the 
image that have known real-world relationships. See Coordinate Transforms 

In-Sight's remote digital camera, which provides an image sensor, trigger input, 
and strobe and video signal outputs. 
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cell 


cell 

reference 


I RJ-45 connector 
\ y (video out) 

— - Trigger + 
^— Trigger - 
Strobe 

_ Strobe - 

In-Sight requires this dedicated camera, which is connected to the Vision Processor 
through a Category 5 cable. 

A location in a worksheet, identified by its row and column address. A occupied cell 
contains a formula that, when evaluated, produces one of the following: 

Value A numeric quantity such as 1.00. 

String One or more alphanumeric characters. 

Structure Multiple values, strings, or both. 

A relationship or "linkage" from one cell to another, specified by its row-column 
address. For example, if cell Al refers to cell Bl, the Al obtains the current value 
from Bl. If Bl changes, then In-Sight updates Al to reflect Bl's new value. Cell 
references can be relative, absolute, or mixed. 


close filter An image processing filter keeps bright features larger than a specified height and 
width. See Image Process/na , 


confusion 
threshold 


A minimum score defining certainty. A feature extraction algorithm can 
immediately accept any feature scoring above this value as an unambiguous 
match. 
100 


8 


— — Confus 


Accept 


•Yes 
Maybe 


continuous 
acquire 


An acceptance threshold , in contrast, is the lowest acceptable score. 

A method for acquiring images that constantly updates the image and the 
worksheet. Live mode , in contrast, passes a stream of images to the display, 
updating the image and worksheet only on exit. 
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Control Pad The handhold keyboard used to navigate the In-Sight interface. 



darkfleld 


Using the Control Pad, you can select menu items, enter text, define image 
processing and feature extraction operations, and so on. The finished application 
can omit the Control Pad if it does not require operator input. See Worktng w/th the 
Contro/ Pad , 

A lighting technique that makes scratches, scribe marks, and other diffuse features 
appear bright on a dark background by reflecting light from a flat, spectral surface 
away from the lens. 


Light 


Rough surface 
(bright feature) 

Smooth surface 
(dark background) 


Briahtfiel d liahtino . in contrast, reflects light into the lens. See Uohtina 
Techniques . 

dependency The relationships between cells, created through the references that connect them. 
One cell depends on another if if contains a formula that refers to it. 



diffuse 
reflection 


Light rays scattered off a rough surface. Contrast with specular refJect/on. 


dilate filter An image processing filter that enlarges light features and reduces dark features by 
a specified height and width. See Image Process mg. 

discrete Independent, genera I- purpose input or output signals connected to screw terminal 
I/O inputs. Two inputs and two outputs are built into the Vision Processor. The optional 

I/O Expansion Module provides up to eight more inputs and eight more outputs, for 
a total of ten each. The interpretation of these independent I/O lines is under 
software control. 

edge A feature extraction technique for finding straight or curved edges in an image, 

detection Each edge is marked by a change in the grayscale values of neighboring pixels 
from light-to-dark or dark-to-light. See Edge Detection . 
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Edit menu A top-level menu used to manipulate worksheet cells, rows, and columns, opened 
by clicking the O button. 


Copy cells to clipboard 
Cut cells, copy to clipboard 
Paste cells from clipboard 
Remove cells, no copy to clipboard 
Open Formula Builder dialog 
Customize the worksheet 
Enable or disable cells 

Hide selected rows 
Unhide hidden rows 
Insert new row above 

Delete current row, shift up 
Set column width or row height 


emitted A formula automatically written to an empty cell by a function that returns a 
formula structure, at its creation, to expose its results. Each emitted formula calls a data 

access function to return one of the values in the structure, eliminating the need to 
create formulas by hand for the individual results. Other formulas can refer to the 
emitted values as data sources. 

Poses object 
(stores Instances 
found in region) 

Indexes of the 
two instances 
found 


Search region 
Instance 0 

Except for its automatic generation, an emitted formula is in every respect the 
same as any other formula. You can freely copy, edit, delete, or otherwise change 
any emitted formula. The reference to the underlying structure is always an 
absolute reference . If you copy an emitted formula, the copy therefore keeps the 
same data source. See Emitted Form u /as . 
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Enter menu A top-level menu for entering data and formulas in cells, opened by clicking the X 
button on the Control Pad. 


Enter numeric value in current cell 

Create a relative reference interactively 

Create an absolute reference interactively 

EdK interactively 

Open Formula Builder dialog 

Open property sheet from current cell 

Closes the Enter menu 


erode 



An image processing filter that reduces bright features and enlarges dark features. 
See Image Processing . 

feature A class of algorithms that extract instances of features from image data. Examples 
extraction are blob analysts , edge detection , histogram analysis , and pattern matching . 


field of 
view 


The physical area seen through the lens. 


Files menu 


filter 


fixture 



Opens Save and Load Job dialog 
Opens Send and Receive Image dialog 
Opens Send and Receive Settings dialog 
Create a new job 


An image p rocessing operation that changes or removes certain features from an 
image while leaving others unchanged. Point operations filter the image based on 
intensity and ignore neighboring pixels. Neighborhood operations consider the 
values of surrounding pixels when changing a pixel value and usually filter the 
image based on spatial frequency. See Image Process/no . 

A coordinate system fixed with respect to the part being inspected. 

Colmnn (inag0^ 


crigin 
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^ Fixtm ralumn 



fixture pont 


Fixture Theta 


Ir 

Production lines often do not perfectly constrain the location or orientation of the 
part. To compensate for this variation, many vision applications establish a fixture 
coordinate system for each image by detecting a feature in each image. The 
application defines subsequent operations relative co the fixture coordinates, in a 
constant location with respect to the part, eliminating image-to-image variation in 
position and orientation. See Working w/th Fixtures . 

flyover A graphic drawn on the image when you select a cell storing an structure , to 
graphics indicate underlying data. With flyover graphics, moving off the cell removes its 
graphics. When you traverse ("fly over") the worksheet, you therefore see a 
context-sensitive indication of relevant data. For example, when you highlight a 
cell containing a Blobs structure, In-Sight draws the blob outlines on the image. 
When you move away from the Blobs structure, the blob outlines vanish. 

If you want a graphic to persist when you move off its cell, you can set the 
associated function's Show parameter to enable input graphics, result graphics, or 
both. See Fl youer Graphics . 

formula An expression in a worksheet, assigned to a single celt, built from values, 

operators, and functions, and returning a value, string, or structure. In-Sight 
provides a Formula Builder for constructing and validating formulas and for 
accessing the built-in image processing, feature extraction, and mathematical 
functions. 

A formula cannot contain a structure , which must reside by itself in a worksheet 
cell. For example, you cannot build a formula like "sqrt(Blobs)", because a Blobs 
structure does not have a square root. Instead, it stores a database of blobs, each 
with an index and a set of measured values. The Data Access functions, which 
underlie the emitted formulas, extract the individual values from a structure for 
use in formulas. 

formula bar The display area at the top of the worksheet or Formula Builder dialog that 
indicates the current cell and current formula: 

Current cell (Row, Column) 

Current formula Insertion pornt 

You can directly edit a formula by moving the insertion point with the Control Pad 
cursor. You insert characters with the Formula Builder keypad; you erase them 
with backspace. 


Formula 
Builder 


Keypad 


A dialog box, used to construct formulas in worksheet cells: 

Function Function 
categories list I 

Current^ 
cell 


Selected 
function 



Formula / 
bar 
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The Formula Builder offers a keypad for text entry and hierarchical menu of vision 
functions, mathematical operators, and other expression elements. See Formufa 
Buifder D/a/oa . 

function An image processing, feature extraction, or mathematical operation selected 

through the Formula Builder, A typical function has several inputs and returns a 
value, a string, or a structure to a cell, Mar.y (but not all) functions have a propertv 
sheet , used to view and change its input values. 

hipass filter An image processing filter that attenuates features larger than the specified height 
and width, reducing low-frequency features. See Imaoe Process/n o, 


histogram 
analysis 


I/O 

expansion 
module 


Image 
arithmetic 


Image 
processing 


In-Slght^ 


Interactive 

reference 

mode 


A feature extraction technique that reduces the image to the frequency distribution 
of its grayscale values. Preparing a histogram involves counting the number the 
number of occurrences of each grayscale value and placing each total a "bin." An 
8-bit image has 256 grayscale values, from 0 (black) to 255 (white), so its 
histogram has 256 bins. The bin number equals the grayscale value totaled there. 
Bin 0, for instance, holds the count of pixels at grayscale 0; bin 1 holds the count 
at grayscale 1; and so on. See Histogram Analysts . 

An optional breakout box, connected to the Vision Processor with a cable, that 
offers terminals for eight discrete inputs and eight discrete outputs. These general- 
purpose I/O lines supplement the two inputs and two outputs directly on the Vision 
Processor. 

An image processing operation that ignores the surrounding pixels when changing 
a pixel value. The constant-to-image algorithms apply a fixed value to every 
pixel. ???Addi(), for example, adds a specified integer to every pixel. The image- 
to-image algorithms, in contrast, combine two images on a pixel-by-pixel basis.. 
Contrast with filter . 

An algorithm that operates on an image and changes its pixel values, returning the 
modified image as a result. For example, a clipping filter limits the grayscale 
values in an image to a particular range, modifying all values outside that range. 
See also image arithmetic . 

A Cognex system for developing and deploying machine vision applications. 
Characteristic features include: 

Spreadsheet interface , adapted for vision processing applications. 

Worksheet-imaoe overlav . which displays the worksheet and image 
simultaneously, with adjustable transparency. 

Structures , which encapsulate complex image or feature data in a single cell. 
Flyover graphics , which display the content of a structure when it is selected. 
Control Pad operation 

Purpose-built hardware including a Vision Processor and a remote camera . 

A view of the worksheet used to define cell references graphically, with the Control 
Pad, instead of by editing their numerical values. See Setting Va/ues Interact/vefy . 
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Job An executable configuration, similar to a software program, that contains a 

worksheet, all of its formulas, and other relevant values. Savin g a job captures the 
current parameter set, but not the current image or global options such as the 
password. In-Sight can store up to 20 jobs in its nonvolatile flash memory, which 
acts like a solid-state hard drive. It can load and run one job at a time, but a job 
can contain many vision operations. 

live mode A feature that passes a stream of images from the camera to the display, without 
acquiring them or updating the worksheet. Typically user* to adjust the tens, since 
it provides immediate feedback. In continuous acquire , in contrast, In-Sight 
constantly updates the image and worksheet. 

iopass filter An image processing filter that removes features smaller than a specified height 
and width, attenuating high-frequency features. See Image Processin g. 

marquee In interactive reference modf^, the highlighting that indicates the current cell: 


mm. 



\ — ' Marquee 




1 





mixed 
reference 


Mode 
dialog 


offline 
mode 


On acceptance, that cell will serve as the source of the reference. 

A cell reference in which one cell coordinate is absolute and the other is relative . 
When a formula containing a mixed reference is copied, the absolute part remains 
unchanged but the relative part changes to preserve the offset relationship. 

For example, suppose cell B2 contains a formula with a mixed reference to cell Al, 
where the column (A) is absolute but the row (1) is relative. Copying B2 to D3 
yields a new formula with a mixed reference to A2: the column is unchanged, but 
the row preserves the offset "one above." 

When building a formula , you can create a mixed reference by creating an absolute 
or relative reference and then editing it, marking the absolute part with a $ 
symbol. 



Enables or disables Secure mode. Operator mode, or Program modes. Opened 
through the System menu. For details, see Work/no w/th Secure , np^r^tnr j^nrf 
Program Modes . 

model A example of a feature used as a template for a pattern-match search. 


An operating state in which In-Sight ignores discrete and serial I/O, disabling all 
communication with other production equipment. In contrast, online mode enables 
I/O, permitting '^normal" operation. For details, see On fine and om/ne Mod^s . 
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online An operating state in which In-Sight responds to discrete and serial I/O, allowing it 

mode to communicate with other production equipment as part of an application. Offline 

mode, in contrast, disables all I/O, isolating In-Sight from other equipment. For 

details, see Onifne and O/fjf/ne Modes . 

open filter An image processing filter that removes dark features smaller than a specified 
height and width. See Ima ge Processin g. 


operator 
mode 


TBW. 


PatFInd"* A Cognex pattern-matching algorithm with both edge-based and area-based 
models. 

pattern A feature extraction algorithm that finds instances of a model In an image. A 
matching pattern-matching algorithm repeatedly compares the model to a region of the 

image, calculating a score value to measure the similarity between the model and 
that region. Higher scores indicate a closer match. See PatF/nd . 

pixel The image coordinate system, in pixel row-and-column values, starting at the top- 

coordinates left of the image. The World coordinate system, in contrast, represents real-world 
locations, measured in inches, millimeters, or another unit. Many applications 
establish a calibrated transformation between Pixel and Wortd coordinates, to map 
from the image to reality and vice versa. 


program 
mode 


TBW. 


property A dialog-box-like list of parameters, used to view and change their values: 
sheet — 


region of 

Interest 

(ROI) 


Parameters 

Reject and close 

Accept and close 
Help text 



Region graphic 


Run once, 
leave open 


When you assign a function to a worksheet cell through the Formula Builder , 
In-Sight opens its property sheet for editing. 

Not all functions have property sheets. None of the "conventional" worksheet 
functions have property sheets because they are usually combined in formulas. 
Most of the extended functions have property isheets, including all of those 
returning structures. See Property Sheet D/a/oo 

An image area within which a function performs an image processing or feature 
extraction operation. To compensate for image-to-image differences in position and 
orientation, an application commonly defines an ROI by row, column, and angle 
offsets from the fixture coordinate system: 
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Usually, the center of the ROI is the expected location of the feature. The size of 
the ROI depends on positional uncertainty. Keeping it as snnall as practical reduces 
the number of pixels to process, in turn reducing processing time. See Deffn/ng a 
Reg/on of Interest , 

relative A cell reference that changes when copied to a new location. For example, if cell Bl 
reference contains a formula including a relative reference to cell Al, and Bl is copied to Dl, 
then the new formula in Dl refers to CI instead of Al. This reference does not 
mean "always point at Al". Instead, it means "always point at the cell above." You 
can create an relative reference from the Formula Builder dialog or from the Enter 
menu . Contrast with absolute reference , and mixed reference . 


secure TBW. 
mode 


Server, In-Sight software that runs on a Windows NT host and communicates with In-Sight 
In-Slght over a serial connection. 


In-Sight Terminal - Sessioni 


Menus 
Toolbar- 


Prompt - 


Status bar- 



Using the Server, you can acquire images, run jobs, read and write values to cells. 
You can also archive jobs for backup or to transfer them from one In-Sight system 
to another. See Using the In-Siaht Server , 
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settings 
menu 


specular 
reflection 

startup 
dialog 


string 

strobe 
structure 


Light rays reflecting off a smooth surface in parallel. Contrast with diffuse 
reffect/on. 


One of the types of data that can be placed in a worksheet cell. A string can 
contain up to 255 alphanumeric characters enclosed in quotes. For example, "this 
is a string". In-Sight offers various functions for manipulating strings. 

A light that generates an extremely brief burst of illumination. Alternatively, a 
signal issued by the camera to fire a strobe light. 

A container that stores multiple values in one cell, typically an image or features 
extracted from an image. The Acquirelmage function, for example, acquires an 
image and stores it in an Image structure, marked Qj. In-5ight uses structures to 
encapsulate multi-dimensional data in a single worksheet cell. 

Each value in a structure can be returned to a cell through a corresponding Data 
Access function. For example, PixelValue() returns the grayscale value for a 
specified pixel in an Image structures. See Understand/na Structures . 



Appendix I - Page 365 


: <WO 0111445A2_L> 


wo 01/11445 


PCTAJSOO/22383 


System 
menu 


Text Entry 
dialog 


A top-level menu, opened by clicking the □ button on the Control Pad, which offers 
"housekeeping" operations such as setting preferences and manipulating jobs. 


Toggle live mode 
Continuous, External, or Manual 
Serial and Discrete I/O 
Save or load jobs or images 
Password locking 
Analyze performance 
System options 
Software information 
Toggle customized interface 



A dialog, used to edit text strings and opened by clicking 
Builder: 


in the Formula 


String under^ 
construction 


>% 
o 


Q. 
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Insertion point 


theta 


See Bntenna Text . 

The fixture angle, in counterclockwise degrees relative to the image row axis. 


tophat filterAn image processing filter that keeps bright features smaller than a specified 
height and width. See Image Process ing. 
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trigger 


Trigger 
menu 


value 


Vision 
Processor 


An input signal that initiates image acquisition. In-Sight supports several kinds of 
triggers: 

l^anua^ Acquires a single image in response to a trigger signal issued by the 
Control Pad, either by holding the □ button and clicking X or by 
selecting Manual from the Triggers menu. Often used during 
development. 

External Acquires a single image in response to: 

A hardware trigger signal sent to the camera's trigger input. 

A software trigger signal issued by a formula in the worksheet. 
Anything referenced by the Acquirelmage function's Internal 
Trigger flag is a potential trigger source. Examples are signals 
from the serial port, discrete I/O, or a software trigger from the 
worksheet. 

Continuous Updates the image and worksheet as quickly as possible. 

Live Mode Constantly updates the image, updating the image and worksheet 
only at exit. 

A second-level menu, opened from the System menu, that sets the trigger type. 


From Control Pad 
Automatic and continuous 
From hardware trigger 


One of the types of data that can be placed in a worksheet cell. A value is a 
numeric quantity. Formulas evaluate to values, strings, or structures. 

A part of the In-Sight hardware— the "main unit" that contains the CPU, memory, 
and so on: 



24 VDC 
Power LEO 



External discrete 
(26-pin connector) 

Discrete I/O 
(8 terminal block) 

Serial 0 
Serial 1 


r^tmAra I inhtjc \/r;A Cnntrnl PstH 
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The camera, Control Pad, and other devices connect to the Vision Processor. 

working The distance from the camera to the object, often dictated by physical or 
distance mechanical constraints. 


world The real-world coordinate system, measured in millimeters or another unit, with a 

coordinates specified origin. The Pixel coordinate system, in contrast, is the image coordinate 

system, in pixel row-and-column values, starting at the top-left of the image. Many 
applications establish a calibrated transformation between Pixel and World 
coordinates, to map from the image to reality and vice versa. 

worksheet In-Sight's spreadsheet-based vision processing interface, displayed on top of the 
image through worksheet overlay . The worksheet is a table of cells, with rows 
identified by number (0 through 999) and columns identified by letter (A through 
Z): 


lma(|e structure, 
stores acquired ^ — 
image 


Current cell- 


worksheet- 
Image 
overlay 


Worksheet columns 



A cell can contain a formula , which evaluates to a value , a string , or a structure . 

In-Sight's characteristic ability to display the worksheet and image simultaneously. 
Viewing them together eliminates the need to alternate between the two views— a 
major convenience when setting up a worksheet based on the features in an 
image. The amount of transparency is adjustable . 
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